# Connect Gmail to Goose

> One streamable-HTTP extension, and Goose can work your inbox.

Goose calls MCP servers extensions, and it renders MCP Apps natively - it fetches a tool's ui:// resource and mounts it in a sandboxed iframe. That makes it one of the hosts where the ranked inbox and the composer show up as real interfaces rather than as text. Adding DaySurface is a single remote extension over streamable HTTP.

## The server URL

```
https://mcp.daysurface.com/mcp
```

Transport is streamable HTTP. Auth is OAuth in the browser - there is no key to
paste and no account to create.

## Before you start

- A Google account with Gmail.
- Goose, desktop or CLI. The desktop app is the one that renders the dashboards.

## Add DaySurface to Goose

1. **Open the extensions settings** - In Goose, go to Settings and then Extensions. This is where both bundled and remote extensions are managed.
2. **Add a remote extension** - Choose to add a custom extension and set its type to streamable HTTP. Goose also supports stdio extensions that run a local process - that is the wrong type here, since DaySurface is a remote server.
3. **Paste the endpoint and name it** - Give the extension a name and paste the DaySurface endpoint as its URL. Leave it enabled when you save.
4. **Sign in with Google** - Goose will take you through the OAuth flow in your browser on first use. Review the scopes before approving them.
5. **Ask it about your inbox** - Start a session and ask what needs you today. In the desktop app the inbox comes back as a dashboard you can act in, not a list you have to read.

## What Goose can do once it is connected

### Triage a ranked inbox without leaving the chat
The inbox arrives as an interactive dashboard rendered inside the conversation, not as a wall of JSON for the model to summarise. You read, rank and clear threads in place.

### Draft replies in a real composer
Replies open in an editable composer you can correct before anything sends. Nothing leaves your account on the model's say-so alone.

### Fill and sign PDF attachments
Attached forms can be filled in from the thread. Signing is a step you complete yourself - the tool never types a signature on your behalf.

### Search across threads by meaning, not just keywords
Search runs server-side over your mail and returns threads, so the agent works from what is actually in your inbox rather than what it can hold in context.

## Questions

### Does the inbox dashboard work in the Goose CLI?
No. The interactive surfaces need a host that can mount an iframe, which means the desktop app. The CLI still gets every tool, it just gets them as text and structured results.

### Is this a stdio extension or a remote one?
Remote, over streamable HTTP. There is no local process to run and nothing to install, so picking the stdio type in the extension dialog will not work.

### Do I need a DaySurface account?
No. There is no account to create and no password to set. You add the server to your client, then sign in to Google when it asks. Authorisation is the whole signup.

### Is there an API key to paste?
No. Auth is OAuth in the browser. If a setup guide anywhere tells you to paste a key, it is not describing this server.

### What does it get access to?
The Google scopes you approve in the consent screen, and nothing else. You can review them at the moment of sign-in and revoke them later from your Google account.

### Can I run it myself instead?
Yes. It is MIT-licensed and self-hostable, and the same tools are exposed over a CLI and a plain HTTP API as well as MCP. Point your client at your own deployment instead of the hosted endpoint.

## More

- Connect Gmail to Claude: https://daysurface.com/connect-gmail-to-claude.md
- Connect Gmail to ChatGPT: https://daysurface.com/connect-gmail-to-chatgpt.md
- Connect Gmail to VS Code: https://daysurface.com/connect-gmail-to-vscode.md
- Connect Gmail to Cursor: https://daysurface.com/connect-gmail-to-cursor.md
- Connect Gmail to Microsoft 365 Copilot: https://daysurface.com/connect-gmail-to-microsoft-365-copilot.md
- Triage argument: https://daysurface.com/ai-email-triage.md
- Every client's install path: https://daysurface.com/connect.md
- Setup reference: https://daysurface.com/docs/mcp/setup
- Full description for LLMs: https://daysurface.com/llms-full.txt