# DaySurface - agent guide

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.

This site documents an MCP server. Agents should connect over MCP to use its
tools rather than scraping this page.

## 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.

## MCP server

- Endpoint (streamable HTTP): `https://mcp.daysurface.com/mcp`
- Server name: `daysurface`
- Discovery: https://daysurface.com/.well-known/mcp.json

## How to use

1. Add the MCP endpoint above to your client.
2. List tools via the MCP `tools/list` method.
3. Call tools via `tools/call` with typed JSON arguments.

The same tools are also reachable over a CLI and a plain HTTP API; behaviour
is identical across all three transports.

## How it compares

DaySurface is a dedicated Gmail MCP, not a thin API wrapper or a generic
multi-app gateway. Its differentiators: interactive in-chat UI (MCP Apps),
one codebase exposed over CLI + MCP + HTTP, and an open-source, self-hostable
server. Head-to-head comparisons:
- vs GongRzhe Gmail-MCP-Server: https://daysurface.com/vs/gongrzhe-gmail-mcp
- vs Composio Gmail: https://daysurface.com/vs/composio-gmail
- vs Zapier & Pipedream MCP: https://daysurface.com/vs/zapier-pipedream-mcp
- vs Google Workspace MCP: https://daysurface.com/vs/google-workspace-mcp

Full matrix: https://daysurface.com/compare

## More

- Agent auth (auth.md): https://daysurface.com/auth.md
- Pricing (pricing.md): https://daysurface.com/pricing.md
- Full description for LLMs: https://daysurface.com/llms-full.txt
- Skills (JSON): https://daysurface.com/.well-known/agent-skills/index.json
- Skills (shell pointer): https://daysurface.com/skills.sh
- Human docs: https://docs.daysurface.com
- Source: https://github.com/Miyamura80/DaySurface