Email for Cursor

Connect Cursor to your email

1. 1. Install Fluxmail and connect a mailbox

   Install the CLI, create the first administrator, and connect Gmail with the local OAuth flow. Outlook needs a Microsoft app registration; IMAP needs provider credentials. The quickstart covers Docker and provider setup.

   npm install -g fluxmail
   fluxmail setup --name "Your name" --email you@example.com
   fluxmail accounts add gmail

   • Gmail and Workspace OAuth
   • Outlook and Exchange setup
   • IMAP and SMTP credentials

2. 2. Add Fluxmail to Cursor

   Add the stdio server to ~/.cursor/mcp.json, or to .cursor/mcp.json in a project:

   {
     "mcpServers": {
       "fluxmail": {
         "command": "fluxmail",
         "args": ["stdio", "--profile", "read-only"]
       }
     }
   }

3. Or connect over HTTP

   To connect over Streamable HTTP, create an API key with fluxmail apikey create --name cursor --profile read-only. Start the server with fluxmail serve unless Docker is already running it, then use the server URL instead:

   {
     "mcpServers": {
       "fluxmail": {
         "url": "http://localhost:8977/mcp",
         "headers": { "Authorization": "Bearer fmk_..." }
       }
     }
   }

Read an attachment alongside your code

The setup above uses read-only access. Try this prompt with a mailbox you connected:

Find the email with subject [replace with a subject you know has an attachment]. List the attached files, then read the CSV attachment and summarize its columns. Do not send mail or change messages.

Check the result

The filename and columns should match the CSV you see in your mail client. If the client cannot fetch an MCP resource link, ask it to download the attachment with inline: true; large files may still exceed provider or client limits.

To create drafts, change the stdio profile or HTTP key to read-write and reconnect. That profile also allows organizing and trashing mail, but cannot send or permanently delete messages. Review a draft in your mail client before sending it yourself.

If the connection does not work

• Check that Fluxmail is enabled in Cursor MCP settings and that the current agent session lists its tools. A project configuration applies only when that project is open.
• If the server connects but no mailbox appears, run fluxmail accounts list as the same operating-system user. Check the instance, member, and mailbox scope used by the client.
• For a command-not-found error, use the absolute path to the installed Fluxmail executable. For HTTP 401, check the API key and Authorization header. For a permission error, check the key or stdio profile before retrying.