Email for Cursor

Fluxmail lets Cursor's agent search, read, draft, and send email in your Gmail, Outlook, Exchange, or IMAP mailboxes. Add it once in mcp.json for every project, or per project when only one codebase needs email.

Set up in CursorRead the MCP client guide

What you can do

Bring a report into the editor

Have Cursor's agent read the email with the error report or feature request and start working from its details.

Review attachments

Download a CSV, log, or PDF attachment from a message so the agent can inspect it next to your code.

Reply without switching apps

Ask the agent to draft a reply to a thread. Review the draft in your mail client, or let Cursor send it if the connection allows sending.

Connect Cursor to your email

  1. 1. Install Fluxmail and connect a mailbox

    Install the CLI, create the first administrator, and connect a mailbox. Use outlook or imap instead of gmail for other providers. The quickstart covers Docker and provider setup.

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

  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"]
    }
  }
}

  3. Or connect over HTTP

    To connect over Streamable HTTP, create an API key with fluxmail apikey create --name cursor. 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_..." }
    }
  }
}

If Cursor cannot find the fluxmail command, use the absolute path printed by which fluxmail. Desktop apps sometimes start with a limited PATH.

Add "--profile", "read-only" to args if the agent should only search and read.

See Permissions for every profile and capability, and the Cursor MCP docs for client settings.

Common questions

Should I configure Fluxmail globally or per project?
Use ~/.cursor/mcp.json when you want email in every project. Use .cursor/mcp.json in a repository when only that project needs it, and keep API keys out of version control.
Can Cursor send email?
Yes, if the connection allows the mail.send capability. The default full profile allows it. Use the read-write profile if Cursor should draft without sending.
Does Fluxmail work with Cursor on Windows and Linux?
Yes. Fluxmail runs anywhere Node.js 20.20.x or 22.22 and newer runs, and it can also run in Docker. Cursor connects to it through stdio or Streamable HTTP.

Reviewed

Build on top of email

Run Fluxmail on your own infrastructure and use it through MCP, REST API, or CLI.

Get started