Triage, draft, sign - without leaving chat.

A real email composer and a ranked inbox, right inside Claude, ChatGPT, or your favorite agent. Your agent triages and writes; you edit and send.

https://mcp.daysurface.com/mcp
Add to Claude

Opens Claude with the name and URL already filled in - just click Add. Claude flags it as suggested by an external link; that's expected. On Team and Enterprise plans an admin adds it.

Didn't work? Add it manually
  1. 1 Open Claude → Settings → Connectors
  2. 2 Click “Add custom connector”
  3. 3 Paste the URL above, then click Add and complete sign-in
Claude

Triage my inbox and draft replies.

I triaged your inbox. Here's the curated view.

gmail_curate_inbox ✓
Curated inbox
123
  • D
    Re: Q3 contract - countersignature 0.86
    Draft × Unread awaiting your reply
    Dana Whitfield
    Looks good on our end. Just need your signature on page 4 before EOD.
    2 days ago
  • P
    Design review for v2 dashboard 0.61
    Unread mentions you
    Priya Nair
    Pushing our review an hour, calendar invite updated.
    5 hours ago
  • S
    Your invoice is ready 0.42
    has attachment
    [email protected]
    Your monthly statement is attached. Total due $1,204.00.
    1 day ago
Inbox
Re: Q3 contract - countersignature
D Dana Whitfield <[email protected]>

Looks good on our end. Just need your signature on page 4 before EOD - once that's in we can countersign and get this filed today.

Draft a researched reply to the Q3 contract thread from Dana.

gmail_reply_to_thread ✓

Researched the thread and drafted a reply, saved to your inbox.

Inbox Draft ready
Re: Q3 contract - countersignature
D Dana Whitfield Just need your signature on page 4… 2d
To [email protected]
Draft saved
Reply to Claude…
ChatGPT Share

Triage my inbox and draft replies.

Here's your inbox, triaged by priority.

Used gmail_curate_inbox
Curated inbox
123
  • D
    Re: Q3 contract - countersignature 0.86
    Draft × Unread awaiting your reply
    Dana Whitfield
    Looks good on our end. Just need your signature on page 4 before EOD.
    2 days ago
  • P
    Design review for v2 dashboard 0.61
    Unread mentions you
    Priya Nair
    Pushing our review an hour, calendar invite updated.
    5 hours ago
  • S
    Your invoice is ready 0.42
    has attachment
    [email protected]
    Your monthly statement is attached. Total due $1,204.00.
    1 day ago
Inbox
Re: Q3 contract - countersignature
D Dana Whitfield <[email protected]>

Looks good on our end. Just need your signature on page 4 before EOD - once that's in we can countersign and get this filed today.

Draft a researched reply to the Q3 contract thread from Dana.

Used gmail_reply_to_thread

Researched the thread and drafted a reply, saved to your inbox.

Inbox Draft ready
Re: Q3 contract - countersignature
D Dana Whitfield Just need your signature on page 4… 2d
To [email protected]
Draft saved
Ask anything
goose

Triage my inbox and draft replies.

On it. Running the inbox tool now.

gmail_curate_inbox
Curated inbox
123
  • D
    Re: Q3 contract - countersignature 0.86
    Draft × Unread awaiting your reply
    Dana Whitfield
    Looks good on our end. Just need your signature on page 4 before EOD.
    2 days ago
  • P
    Design review for v2 dashboard 0.61
    Unread mentions you
    Priya Nair
    Pushing our review an hour, calendar invite updated.
    5 hours ago
  • S
    Your invoice is ready 0.42
    has attachment
    [email protected]
    Your monthly statement is attached. Total due $1,204.00.
    1 day ago
Inbox
Re: Q3 contract - countersignature
D Dana Whitfield <[email protected]>

Looks good on our end. Just need your signature on page 4 before EOD - once that's in we can countersign and get this filed today.

Draft a researched reply to the Q3 contract thread from Dana.

gmail_reply_to_thread

Researched the thread and drafted a reply, saved to your inbox.

Inbox Draft ready
Re: Q3 contract - countersignature
D Dana Whitfield Just need your signature on page 4… 2d
To [email protected]
Draft saved

goose · 9:42 AM

Ask goose anything…
3 extensions
Chat ⋯
U

Triage my inbox and draft replies.

Triaged your inbox in agent mode:

Ran gmail_curate_inbox
Curated inbox
123
  • D
    Re: Q3 contract - countersignature 0.86
    Draft × Unread awaiting your reply
    Dana Whitfield
    Looks good on our end. Just need your signature on page 4 before EOD.
    2 days ago
  • P
    Design review for v2 dashboard 0.61
    Unread mentions you
    Priya Nair
    Pushing our review an hour, calendar invite updated.
    5 hours ago
  • S
    Your invoice is ready 0.42
    has attachment
    [email protected]
    Your monthly statement is attached. Total due $1,204.00.
    1 day ago
Inbox
Re: Q3 contract - countersignature
D Dana Whitfield <[email protected]>

Looks good on our end. Just need your signature on page 4 before EOD - once that's in we can countersign and get this filed today.

U

Draft a researched reply to the Q3 contract thread from Dana.

Ran gmail_reply_to_thread

Researched the thread and drafted a reply, saved to your inbox.

Inbox Draft ready
Re: Q3 contract - countersignature
D Dana Whitfield Just need your signature on page 4… 2d
To [email protected]
Draft saved

Ask Copilot

Agent Auto

Works with every MCP client

  • Claude
  • Codex
  • Cursor
  • ChatGPT
  • VS Code
  • OpenClaw
  • Goose

Every action lands somewhere you can edit.

Replies open in a real composer, triage banks what your agent already read, and PDFs get filled for you to sign. Nothing leaves your account until you send it.

  1. Drafted a reply to Dana - it's open for you to edit.

    Inbox Draft ready
    Re: Q3 contract - countersignature
    D Dana Whitfield Just need your signature on page 4… 2d
    To [email protected]
    Draft saved
    01

    Drafts you edit, not approve

    Replies land in a real Gmail draft with a composer rendered inside the chat - recipients, subject, body and attachments, all editable in place. Your agent writes the first version; nothing sends until you press send.

  2. I triaged your inbox. Here's what needs you.

    Curated inbox
    123
    • D
      Re: Q3 contract - countersignature 0.86
      Draft × Unread awaiting your reply
      Dana Whitfield
      Looks good on our end. Just need your signature on page 4 before EOD.
      2 days ago
    • P
      Design review for v2 dashboard 0.61
      Unread mentions you
      Priya Nair
      Pushing our review an hour, calendar invite updated.
      5 hours ago
    • S
      Your invoice is ready 0.42
      has attachment
      [email protected]
      Your monthly statement is attached. Total due $1,204.00.
      1 day ago
    Inbox
    Re: Q3 contract - countersignature
    D Dana Whitfield <[email protected]>

    Looks good on our end. Just need your signature on page 4 before EOD - once that's in we can countersign and get this filed today.

    02

    Triage that remembers

    Your agent reads a thread once and banks its verdict. Each judgment is stamped against the thread's Gmail history, so the next "what needs me?" only re-reads what actually changed - instead of re-running a search and starting from zero.

  3. Filled the form. It needs your signature to go back.

    terms-v3.pdf Awaiting your signature ✓ Signed by Alex Rivera
    Signature
    Sign here Alex Rivera
    Sign as (full legal name)
    Alex Rivera
    I agree that typing my name constitutes my electronic signature.
    Cancel Sign document Signing…
    ✓ Signed by Alex Rivera · 2026-07-28 14:22 UTC Signed copy attached to your Gmail draft. The assistant filled the fields. Only you could sign.
    03

    Fill and sign, in the thread

    Your agent opens a PDF attachment, fills its form fields, and hands it back for signature. The bytes stay server-side and never enter the conversation - and signing is a step only you can complete, by typing your own name.

How DaySurface compares

Most Gmail MCPs hand your agent a wall of JSON. DaySurface is a Gmail product: an inbox you drive from inside the chat, open source and yours to host.

Interactive UI, not just JSON

A real composer and a ranked inbox, rendered inside the chat.

MCP, CLI, API interfaces

One service registry behind all three. Behaviour never drifts.

Open source and self-hostable

Your infrastructure, your OAuth credentials, no gateway in between.

Capability DaySurface GongRzhe Gmail-MCP-Server Composio Gmail Zapier & Pipedream MCP Google Workspace MCP
Interactive in-chat UI (MCP Apps)
Composer + ranked-inbox dashboard rendered inside the chat client.
 ✓ – JSON only – JSON only – JSON only – JSON only
Built-in inbox triage & ranking
An importance-ranked inbox out of the box, not just raw search.
 ✓ – raw search – raw search ~ build a workflow – raw search
One codebase → CLI + MCP + HTTP
Identical tools across every interface, no duplicated logic.
 ✓ ~ stdio / HTTP – hosted endpoint – hosted endpoint ~ MCP only
Zero-install (remote streamable HTTP)
Connect by pasting a URL - nothing to install locally.
 ✓ – local install ✓ ✓ – self-run
Open source & self-hostable
Run the full server on your own infrastructure.
 ✓ ✓ – proprietary – proprietary ✓
Minimal scope + encrypted tokens
A single Gmail scope with tokens encrypted at rest.
 ✓ ~ local token file ✓ managed ✓ managed ~ broad scopes

Comparison reflects publicly documented capabilities as of June 2026. The MCP ecosystem moves fast - if something here is out of date, open an issue and we'll fix it.

See the full comparison

Trusted by builders

“We had a production MCP server in front of our agents the same afternoon. The shared registry meant our CLI and API just worked too.”
Placeholder NameStaff Engineer, Placeholder Co.
“The typed schemas are the killer feature. Our agent stopped guessing argument shapes overnight.”
Placeholder NameFounder, Placeholder AI

Pricing

The full Gmail experience is free forever, and always will be. Paid tiers buy autonomy and throughput, governance is an add-on you attach when you need it, and you can self-host the whole thing for nothing.

Interactive is free. Autonomous is paid. Scale when you need to.

Free

DaySurface
$0forever

Everything you can do in the Gmail web UI, done through your agent instead. Not a trial.

  • Read, search, and triage your whole inbox
  • Draft, reply, and send
  • Interactive MCP Apps (composer + ranked inbox)
  • 1 connected mailbox
  • 500 tool calls per day
  • 30 days of curation memory
  • 3 PDF signatures per month
  • MIT-licensed - self-host every feature
  • Community support
Start free

Team

$29/mo

5 members included. $6/mo per extra member. No card up front.

Everything DaySurface does, for you and up to four colleagues. It keeps working after you close the chat.

  • Everything in Free, for all 5 members
  • Follow-up Manager - nothing slips
  • Webhooks + real-time inbox watch
  • Scheduled rules
  • Unlimited curation memory
  • Unlimited PDF signing
  • Shared team rules + shared mailboxes
  • Audit log + admin console
  • 5,000 tool calls per day
  • Priority support
Start 14-day trial

Scaling

$199/mo

25 members included. $5/mo per extra member.

Same product, far more headroom. For teams running agents against their mail all day rather than a few times an hour.

  • Everything in Team
  • 25 members included
  • 50,000 tool calls per day
  • 25 concurrent agent sessions
  • 100k webhook deliveries per day
  • Priority background job queue
  • Higher curation throughput
  • Usage analytics + per-member breakdown
  • Priority support with a response target
Start 14-day trial

Enterprise

Custom

Procurement, uptime commitments, and deployment on infrastructure you control.

  • Everything in Scaling
  • Unlimited members and custom limits
  • Governance add-on included
  • Uptime SLA + DPA
  • Dedicated or VPC deployment
  • Security review + procurement support
  • Self-host support contract
  • Named onboarding + dedicated support
Contact sales

Open source and MIT-licensed: self-host every feature for nothing.

Compare every feature, and the governance add-on →

Ask AI about this

Have your assistant explain DaySurface, compare it, or walk you through deploying it.

Ask in ChatGPT Ask in Perplexity Ask in Claude

Frequently asked questions

Which MCP clients are supported?

Any client that speaks the Model Context Protocol: Claude Desktop, Claude Code, Cursor, Cline, VS Code, Windsurf, and more. The server exposes a standard tool/resource surface.

stdio or streamable HTTP?

Both. Streamable HTTP is the primary transport (mounted at /mcp alongside the HTTP API in one process), and stdio is available for local/dev use.

How does authentication work?

The MCP mount supports OAuth 2.1 as a resource server, sharing auth and CORS with the HTTP API. You can also run it unauthenticated for local development.

Do I need to install anything to use it?

No. Because the server runs over streamable HTTP, connecting is just pasting its URL into your agent client. No local install, runtime, or download required. (Self-hosting the server is a separate, optional step.)

Does it work on mobile?

Yes, anywhere your agent runs. Since it's a remote HTTP server with nothing to install locally, it works in any agent app that has a mobile app, including the Claude and ChatGPT mobile apps.

Can I self-host?

Yes. The whole thing is open source and ships with a Dockerfile and Railway config. Deploy it anywhere that runs a container.

What about my existing CLI / API?

They share the same service registry. Add a tool once and it's available over CLI, MCP, and HTTP simultaneously, with no duplicated logic.

Is there an /ask (NLWeb) endpoint?

Yes. There's a public, NLWeb-conformant /ask endpoint for natural-language questions answered from the docs (server-side Q&A with SSE streaming). It's distinct from the /mcp action-tool surface, which exposes callable tools. /ask is disabled by default; enable it via config (ask.enabled: true).

Is this just another Gmail API wrapper?

No. Most Gmail MCPs (like GongRzhe's) wrap the Gmail API and return JSON. DaySurface renders interactive MCP Apps - a composer you edit drafts in and a ranked inbox you triage - directly inside the chat, and exposes the same tools over CLI and HTTP, not just MCP. See the comparison at /compare.

How is it different from Composio, Zapier, or Google Workspace MCP?

Those are broad gateways or suites where Gmail is one generic toolkit among many. DaySurface goes deep on Gmail with an interactive in-chat inbox, and it's open source and self-hostable so your mail never routes through a proprietary service. Full breakdown at /compare.

Ship your MCP server today.

Clone the repo, deploy it, and point your agent at the URL.

https://mcp.daysurface.com/mcp
Add to Claude

Opens Claude with the name and URL already filled in - just click Add. Claude flags it as suggested by an external link; that's expected. On Team and Enterprise plans an admin adds it.

Didn't work? Add it manually
  1. 1 Open Claude → Settings → Connectors
  2. 2 Click “Add custom connector”
  3. 3 Paste the URL above, then click Add and complete sign-in
  • Three transports, one codebase
  • Headless or interactive tools
  • Streamable HTTP, one port
  • Open source, self-hostable 
# DaySurface - An MCP server for Gmail

> An MCP server for Gmail: triage a ranked inbox, draft replies in a real composer, and fill and sign PDF attachments - inside Claude, ChatGPT, or any MCP client.

Triage, draft, sign - without leaving chat. A real email composer and a ranked inbox, right inside Claude, ChatGPT, or your favorite agent. Your agent triages and writes; you edit and send.

- Website: https://daysurface.com
- MCP endpoint (streamable HTTP): https://mcp.daysurface.com/mcp
- MCP server name: daysurface
- Documentation: https://daysurface.com/docs
- Source code: https://github.com/Miyamura80/DaySurface

## What it is

DaySurface is a Model Context Protocol (MCP) server. It exposes a single
shared service registry over three interfaces - a CLI, an MCP server
(streamable HTTP), and a plain HTTP API - so the same typed tools behave
identically no matter how they are called. Any agent that speaks MCP can
discover and call its tools.

## When to use

Reach for DaySurface when a task needs Gmail actions - reading, searching, triaging, drafting, or sending mail - on the user's behalf.

Use DaySurface when:
- The user asks to read, search, or summarize their email (e.g. "what did Sarah send about the contract?").
- The user asks to triage or prioritize their inbox - call `gmail_curate_inbox` to rank threads by importance.
- The user asks to draft, reply to, or send a message - draft first and let the user review before sending.
- Another task needs a fact that lives in the user's mail (an invoice total, a confirmation number, a meeting time).

Do not use DaySurface when:
- The request is about a different mail provider (Outlook, Proton) - these tools are Gmail-only.
- The user has not connected an account or granted access - complete the auth flow (see auth.md) first.
- The task is purely local or computational and needs no access to the user's mailbox.

## Connecting

Add the streamable-HTTP endpoint https://mcp.daysurface.com/mcp to any MCP client. Nothing to
install locally. Server name: `daysurface`.

### Claude
One-click install link on the site.
Opens Claude with the name and URL already filled in - just click Add. Claude flags it as suggested by an external link; that's expected. On Team and Enterprise plans an admin adds it.

### ChatGPT
Install link on the site opens the setup dialog; the fields come up empty, so paste the server URL there and confirm. If the link is blocked or unavailable, the full path from scratch is:
1. Settings → Connectors → Advanced settings → Developer mode on
2. Back on Connectors, click Create
3. Paste the URL, name it, Authentication → OAuth
4. Tick the risk box, click Create
5. New chat, so the tools menu refreshes
Copies the URL, then opens the empty dialog - just paste. Needs Developer mode on first.

### Claude Code
Run this in a terminal:

claude mcp add --transport http --scope user daysurface https://mcp.daysurface.com/mcp
Run it in your terminal, then /mcp in a session to sign in.

### Cursor
One-click install link on the site.
Opens Cursor and adds the server. Not working? Copy the URL above and add it under Settings → MCP.

### VS Code
One-click install link on the site.
Opens VS Code and adds the server. Requires Copilot agent mode.

### Goose
One-click install link on the site.
Opens Goose and adds the extension over streamable HTTP.

### Cline
Paste this into the agent:

Add a remote MCP server, then verify it connects.

  Name:      daysurface
  Endpoint:  https://mcp.daysurface.com/mcp
  Transport: streamable HTTP (remote, not stdio)
  Auth:      OAuth in the browser, no key to paste

Use THIS client's own config keys - they differ:
VS Code "servers", Cursor/Cline "mcpServers",
Zed "context_servers", Windsurf "serverUrl" not "url".
Keep existing servers. Show me the diff, then say
what to click to finish sign-in.
Or add it by hand: MCP Servers → Remote Servers → Streamable HTTP.

### Zed
Paste this into the agent:

Add a remote MCP server, then verify it connects.

  Name:      daysurface
  Endpoint:  https://mcp.daysurface.com/mcp
  Transport: streamable HTTP (remote, not stdio)
  Auth:      OAuth in the browser, no key to paste

Use THIS client's own config keys - they differ:
VS Code "servers", Cursor/Cline "mcpServers",
Zed "context_servers", Windsurf "serverUrl" not "url".
Keep existing servers. Show me the diff, then say
what to click to finish sign-in.
Or add it by hand: Settings → AI → MCP Servers → Add Remote Server.

### Windsurf
Paste this into the agent:

Add a remote MCP server, then verify it connects.

  Name:      daysurface
  Endpoint:  https://mcp.daysurface.com/mcp
  Transport: streamable HTTP (remote, not stdio)
  Auth:      OAuth in the browser, no key to paste

Use THIS client's own config keys - they differ:
VS Code "servers", Cursor/Cline "mcpServers",
Zed "context_servers", Windsurf "serverUrl" not "url".
Keep existing servers. Show me the diff, then say
what to click to finish sign-in.
Windsurf uses “serverUrl”, not “url” - a snippet copied from another client will fail silently.

### Any MCP client
Paste this into the agent:

Add a remote MCP server, then verify it connects.

  Name:      daysurface
  Endpoint:  https://mcp.daysurface.com/mcp
  Transport: streamable HTTP (remote, not stdio)
  Auth:      OAuth in the browser, no key to paste

Use THIS client's own config keys - they differ:
VS Code "servers", Cursor/Cline "mcpServers",
Zed "context_servers", Windsurf "serverUrl" not "url".
Keep existing servers. Show me the diff, then say
what to click to finish sign-in.
Anything that speaks MCP over streamable HTTP works - there is nothing to install.

## Features

### Drafts you edit, not approve
Replies land in a real Gmail draft with a composer rendered inside the chat - recipients, subject, body and attachments, all editable in place. Your agent writes the first version; nothing sends until you press send.

### Triage that remembers
Your agent reads a thread once and banks its verdict. Each judgment is stamped against the thread's Gmail history, so the next "what needs me?" only re-reads what actually changed - instead of re-running a search and starting from zero.

### Fill and sign, in the thread
Your agent opens a PDF attachment, fills its form fields, and hands it back for signature. The bytes stay server-side and never enter the conversation - and signing is a step only you can complete, by typing your own name.

## How it compares

Most Gmail MCPs hand your agent a wall of JSON. DaySurface is a Gmail product: an inbox you drive from inside the chat, open source and yours to host.

What makes DaySurface different (as of June 2026):
- **Interactive UI, not just JSON**: DaySurface renders MCP Apps - sandboxed UI that lives inside the chat. Review and edit a draft in a real composer, then triage a ranked inbox in an embedded dashboard, all without leaving your agent. The inbox ranking and triage flow exist because the interactive surface makes them useful; other Gmail MCPs return raw search results and stop there.
- **MCP, CLI, API interfaces**: Every tool is a pure function in a shared registry, exposed identically over a CLI, an MCP server, and a plain HTTP API. Build once and call it from your shell, any MCP client, or a script - behavior never drifts between interfaces. Most Gmail MCPs are single-transport: stdio-only, or a hosted endpoint you can't run locally.
- **Open source and self-hostable**: The whole server is open source and ships with a Dockerfile and deploy config, so you can run it on your own infrastructure with your own OAuth credentials and encrypted token storage. Aggregator gateways route your mail through a proprietary service you don't control.

### DaySurface vs GongRzhe Gmail-MCP-Server
The open-source Gmail MCP, upgraded. GongRzhe's server is a faithful, well-loved wrapper around the Gmail API - around a dozen tools for send, draft, read, search, labels and attachments, run locally over stdio with a credentials file on disk. You get clean primitives and JSON back. DaySurface shares the open-source spirit but goes further: it renders an interactive composer and a ranked-inbox dashboard inside the chat, and the same tools are reachable over a CLI and an HTTP API, not just stdio.

- Choose DaySurface if: you want an in-chat composer and inbox triage UI, remote zero-install access, and the same tools available over CLI and HTTP as well as MCP.
- Choose GongRzhe Gmail-MCP-Server if: you want a minimal, local, stdio-only Gmail wrapper to embed in a desktop client and you're happy driving everything through JSON tool calls.
- Full comparison: https://daysurface.com/vs/gongrzhe-gmail-mcp

### DaySurface vs Composio Gmail
A Gmail product, not a Gmail endpoint in a 500-app gateway. Composio's strength is breadth: one managed endpoint and hosted OAuth across hundreds of SaaS apps, with Gmail exposed as a generic search / read / draft / send toolkit. DaySurface trades breadth for depth on email - an interactive composer and ranked-inbox dashboard rendered in the chat - and it's open source, so you self-host with your own credentials instead of routing mail through a proprietary gateway.

- Choose DaySurface if: email is the job: you want an interactive in-chat inbox, full control of your own deployment, and the ability to run the same tools over CLI and HTTP.
- Choose Composio Gmail if: you need one managed endpoint spanning many SaaS apps and you don't want to run any infrastructure yourself.
- Full comparison: https://daysurface.com/vs/composio-gmail

### DaySurface vs Zapier & Pipedream MCP
Built for an agent in the loop, not a no-code workflow. Zapier and Pipedream expose Gmail as actions inside their automation platforms - great for fire-and-forget workflows, with tools often auto-generated from API specs. DaySurface is purpose-built for a human-in-the-loop agent: an interactive composer where you review and edit before anything sends, a ranked inbox you triage in-chat, and an open-source codebase you host yourself rather than orchestrate through a workflow runner.

- Choose DaySurface if: you want an agent that drafts and triages with you interactively, a focused Gmail surface, and a server you own and self-host.
- Choose Zapier & Pipedream MCP if: your goal is automated, multi-app workflows triggered by events, and you're already invested in their builder.
- Full comparison: https://daysurface.com/vs/zapier-pipedream-mcp

### DaySurface vs Google Workspace MCP
Gmail done deeply vs. Workspace done broadly. Google Workspace MCP covers a huge surface - Gmail, Calendar, Drive and Docs - as headless tools you run yourself. It's a great fit when you need the whole suite. DaySurface goes the other way: deep on Gmail with an interactive in-chat composer and ranked-inbox dashboard, a minimal single Gmail scope, and the same tools exposed over CLI and HTTP as well as MCP.

- Choose DaySurface if: Gmail is the priority and you want an interactive inbox UI, scope minimalism, and multi-transport access.
- Choose Google Workspace MCP if: you need Calendar, Drive and Docs alongside Gmail in one server.
- Full comparison: https://daysurface.com/vs/google-workspace-mcp

See the full comparison and capability matrix at https://daysurface.com/compare.

## Compatible clients

Works with every MCP client, including: Claude, Codex, Cursor, ChatGPT, VS Code, OpenClaw, Goose.

## How to connect

1. Copy the MCP server URL: https://mcp.daysurface.com/mcp
2. Add it to your client (server name `daysurface`):
   - Claude: one-click install (deep link supported).
   - ChatGPT: Settings → Connectors → Advanced settings → Developer mode on → Back on Connectors, click Create → Paste the URL, name it, Authentication → OAuth → Tick the risk box, click Create → New chat, so the tools menu refreshes
   - Claude Code: run `claude mcp add --transport http --scope user daysurface https://mcp.daysurface.com/mcp`
   - Cursor: one-click install (deep link supported).
   - VS Code: one-click install (deep link supported).
   - Goose: one-click install (deep link supported).
   - Cline: paste the setup prompt shown under "Connecting" above.
   - Zed: paste the setup prompt shown under "Connecting" above.
   - Windsurf: paste the setup prompt shown under "Connecting" above.
   - Any MCP client: paste the setup prompt shown under "Connecting" above.
3. Your agent discovers the tools automatically and calls them with typed inputs.

## FAQ

### Which MCP clients are supported?
Any client that speaks the Model Context Protocol: Claude Desktop, Claude Code, Cursor, Cline, VS Code, Windsurf, and more. The server exposes a standard tool/resource surface.

### stdio or streamable HTTP?
Both. Streamable HTTP is the primary transport (mounted at /mcp alongside the HTTP API in one process), and stdio is available for local/dev use.

### How does authentication work?
The MCP mount supports OAuth 2.1 as a resource server, sharing auth and CORS with the HTTP API. You can also run it unauthenticated for local development.

### Do I need to install anything to use it?
No. Because the server runs over streamable HTTP, connecting is just pasting its URL into your agent client. No local install, runtime, or download required. (Self-hosting the server is a separate, optional step.)

### Does it work on mobile?
Yes, anywhere your agent runs. Since it's a remote HTTP server with nothing to install locally, it works in any agent app that has a mobile app, including the Claude and ChatGPT mobile apps.

### Can I self-host?
Yes. The whole thing is open source and ships with a Dockerfile and Railway config. Deploy it anywhere that runs a container.

### What about my existing CLI / API?
They share the same service registry. Add a tool once and it's available over CLI, MCP, and HTTP simultaneously, with no duplicated logic.

### Is there an /ask (NLWeb) endpoint?
Yes. There's a public, NLWeb-conformant /ask endpoint for natural-language questions answered from the docs (server-side Q&A with SSE streaming). It's distinct from the /mcp action-tool surface, which exposes callable tools. /ask is disabled by default; enable it via config (ask.enabled: true).

### Is this just another Gmail API wrapper?
No. Most Gmail MCPs (like GongRzhe's) wrap the Gmail API and return JSON. DaySurface renders interactive MCP Apps - a composer you edit drafts in and a ranked inbox you triage - directly inside the chat, and exposes the same tools over CLI and HTTP, not just MCP. See the comparison at /compare.

### How is it different from Composio, Zapier, or Google Workspace MCP?
Those are broad gateways or suites where Gmail is one generic toolkit among many. DaySurface goes deep on Gmail with an interactive in-chat inbox, and it's open source and self-hostable so your mail never routes through a proprietary service. Full breakdown at /compare.

## Machine-readable resources

- llms.txt: https://daysurface.com/llms.txt
- llms-full.txt: https://daysurface.com/llms-full.txt
- agents.md: https://daysurface.com/agents.md
- auth.md (agent auth manifest): https://daysurface.com/auth.md
- pricing.md (machine-readable pricing): https://daysurface.com/pricing.md
- Agent skills (JSON): https://daysurface.com/.well-known/agent-skills/index.json
- Agent skills (shell pointer): https://daysurface.com/skills.sh
- MCP discovery (JSON): https://daysurface.com/.well-known/mcp.json
- Sitemap: https://daysurface.com/sitemap.xml
- Schema map: https://daysurface.com/schemamap.xml