Give Cursor your inbox, read-only
Bug reports, customer threads and vendor receipts live in email. Add one entry to mcp.json and Cursor's agent can read them without you copying and pasting.
{
"mcpServers": {
"emailgents": {
"url": "https://emailgents.com/mcp"
}
}
}server: https://emailgents.com/mcp
Setup
Sign in happens in the browser once; the client remembers it.
- 01Connect your mailboxes in EmailgentsSign up at emailgents.com and add your accounts under Mailboxes.
- 02Add the server to mcp.jsonOpen Cursor Settings, MCP, and add a new server, or paste the snippet below into ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
- 03Sign in onceCursor shows Emailgents with a Needs login state. Click it to open the browser sign-in and approve the connection.
- 04Ask the agentIn Agent mode, ask about your mail; Cursor calls the Emailgents tools and shows each call before it runs.
Things to ask
- “Find the email where the client described the checkout bug and turn it into a reproduction checklist.”
- “Get the API key rotation notice from our payment provider and list the deadlines.”
- “Open the latest thread with the designer and extract the requested changes as a todo list.”
Good to know
- Cursor runs remote MCP servers over streamable HTTP; no local process or Node install is needed.
- Project-level .cursor/mcp.json lets a team share the configuration while each person signs in with their own Emailgents account.
Cursor questions
Do I need an API key?
Not for MCP. You sign in to Emailgents in the browser when the client connects and approve once. API keys exist for scripts that use the REST API instead.
Which inboxes will it see?
Every mailbox you have connected in Emailgents: Gmail and Google Workspace, Outlook and Microsoft 365, iCloud, Yahoo, Fastmail, AOL, Zoho, GMX, WEB.DE and any IMAP server. Add or remove mailboxes in Emailgents and the agent sees the change on its next call.
Can it read several accounts at once?
Yes. search_messages and inbox_overview cover every connected mailbox by default. Pass account_ids to narrow to one; each result carries its account so the agent can tell them apart.
Can it send, delete or move my mail?
No. The tool set is read-only apart from set_flags, which toggles read and starred. An instruction hidden inside an email cannot make the agent send anything on your behalf, and every call is listed on your Activity page.
Other agents
- ClaudeClaude's built-in Gmail connector handles one Google account. Add Emailgents once and Claude reads all of your mailboxes, iCloud and IMAP included.2 min
- Claude CodeOne command in the terminal. Claude Code can then pull the bug report from your work mail, the invoice from iCloud and the Stripe receipt from Gmail without leaving the session.1 min
- ChatGPTChatGPT's built-in apps cover Gmail and Outlook. With Emailgents as a connector it also reads iCloud, Yahoo, Fastmail and your second Gmail, through one sign-in.3 min
- CodexCodex CLI, the IDE extension and the ChatGPT desktop app share one MCP configuration. Add Emailgents once and all of them can read your mail.2 min
- Gemini CLIGemini in Gmail reads one Google account. Gemini CLI with Emailgents reads every inbox you own, from the terminal.2 min
- WindsurfCascade reads remote MCP servers from one config file. Add Emailgents and it can pull the customer thread or the vendor receipt into the task.2 min
- VS CodeCopilot agent mode speaks MCP. Add Emailgents and it can read the bug report, the contract or the receipt without leaving the editor.2 min
- Custom agents and scriptsFrameworks that speak MCP connect to the same server as Claude and Cursor. Everything else uses the REST API with a key you can scope to specific mailboxes.5 min