Quick Start
Connect DaySurface to your MCP client and run your first inbox triage
There is nothing to install. DaySurface runs as a remote streamable-HTTP MCP server, so connecting is a matter of adding one URL to your client and granting Gmail access once.
https://mcp.daysurface.com/mcpAdd the server to your client
Pick your client in the connect box on the product site: most install in one click, and the rest get a command or a setup prompt to paste.
Per-client detail - including config-file snippets and local stdio for development - is in MCP Setup.
Connect your Gmail account
Ask your assistant to connect Gmail, or call gmail_connect directly. It
returns a Google sign-in link; approving it links the account to your session.
Access uses Google's gmail.modify scope - read, label, draft, and send, but
never a permanent delete. Call gmail_status to check the connection and
gmail_disconnect to revoke it, which also erases the stored tokens.
Triage your inbox
Ask for what you actually want:
What needs my attention in my inbox today?Your assistant calls gmail_curate_inbox, which ranks recent threads with a
deterministic score and renders an inbox dashboard right in the chat.
Draft a reply
Reply to Sarah's email about the contract - say we can meet Thursday.The reply lands in a real Gmail draft in an interactive composer. Edit it there, then send. Your assistant never sends without you.
Prefer to self-host?
The whole server is open source and ships with a Dockerfile and Railway config. Run it on your own infrastructure with your own Google OAuth credentials:
git clone https://github.com/Miyamura80/DaySurface.git
cd DaySurface
uv sync
uv run daysurface-serveThat single process serves both the REST API and the MCP endpoint at /mcp.
See Deployment for hosting and
OAuth 2.1 for wiring up client authentication.