Skip to content
MCP server

NexusAGYmail

Local Gmail server for Google Antigravity that sends drafts only after your yes

Runs locallyStatus and history
Pricing
Open source
Platforms
Windows, self-hosted
Runs
Locally
Version
0.17.1
Listing updated
3 days ago

About NexusAGYmail

NexusAGYmail is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.

Google Antigravity has no Gmail connector, and this server fills the gap with a local Windows program that talks to the official Gmail API using your own OAuth client. The token is kept on the machine and encrypted with DPAPI; there is no cloud relay, telemetry or browser automation.

Tool names and parameters follow Google's official Gmail MCP server, with four extra tools. Reading and drafting are open, but sending is gated: send_draft shows the exact draft and issues a single-use approval valid for ten minutes, and an email cannot trigger a send. Nothing is deleted for good, since trash is reversible for 30 days and there is no permanent-delete tool. Each incoming email is framed as data and hidden instructions inside it are flagged.

It is a single native executable (C#, Native AOT) for Windows 10 and 11, x64 or Arm64, released under MIT.

Install

Run in a terminal

claude mcp add nexus-agymail -- npx -y https://github.com/pironjulien/NexusAGYmail/releases/download/v0.17.1/nexus-agymail-0.17.1-win-x64.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "nexus-agymail": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusAGYmail/releases/download/v0.17.1/nexus-agymail-0.17.1-win-x64.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "nexus-agymail": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusAGYmail/releases/download/v0.17.1/nexus-agymail-0.17.1-win-x64.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "nexus-agymail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusAGYmail/releases/download/v0.17.1/nexus-agymail-0.17.1-win-x64.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "nexus-agymail": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusAGYmail/releases/download/v0.17.1/nexus-agymail-0.17.1-win-x64.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "nexus-agymail": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusAGYmail/releases/download/v0.17.1/nexus-agymail-0.17.1-win-x64.mcpb"
      ]
    }
  }
}

Configuration

  • NEXUS_AGYMAIL_HOMEState folder (token, OAuth client) instead of ~/.nexus/nexus-agymail
  • NEXUS_AGYMAIL_CLIENT_SECRETPath of your Desktop app OAuth client JSON (otherwise the copy made by `NexusAGYmail.exe auth`)
  • NEXUS_AGYMAIL_PROTECTEDExtra folders whose files are never attached to a draft (;-separated)
  • NEXUS_AGYMAIL_HOMEState folder (token, OAuth client) instead of ~/.nexus/nexus-agymail
  • NEXUS_AGYMAIL_CLIENT_SECRETPath of your Desktop app OAuth client JSON (otherwise the copy made by `NexusAGYmail.exe auth`)
  • NEXUS_AGYMAIL_PROTECTEDExtra folders whose files are never attached to a draft (;-separated)

Tools this server provides (11)

Taken from the project documentation; the running server may differ.

search_threads
Searches Gmail threads using Gmail syntax.
get_message
Reads one message as text.
get_thread
Reads one thread.
list_new_messages
Lists messages that arrived since the previous call.
download_attachment
Saves an attachment under a sanitised name.
create_draft
Creates a draft in Gmail.
update_draft
Updates a draft.
get_draft
Reads a draft back.
create_label
Creates a label, including nested ones.
send_draft
Sends a draft only with consent for that draft.
auth_status
Shows token location, scopes and whether to reconnect.

What it does

Approval-gated sending
send_draft re-reads the draft and only sends after consent for that exact draft.
Thread search and reading
Searches Gmail threads and returns messages with quoted replies stripped.
Draft handling
Creates, updates and reads drafts, including replies in the same thread.
Labels and archive
Labels or archives up to 100 items per call and creates nested labels.
Reversible trash
Moves mail to trash and restores it within 30 days.
Prompt-injection guardrails
Frames every email as data and flags hidden instructions.

Good for

  • Let an Antigravity agent triage an inbox
  • Draft replies and review them before sending
  • Save an email attachment to the Downloads folder
  • Label and archive batches of messages

Pricing

Open source

MIT licence

Prices change. Check julienpiron.fr before you buy.

NexusAGYmail FAQ

Can the agent delete mail permanently?

No. There is no permanent-delete tool and trash is reversible for 30 days.

Which systems does it run on?

Windows 10 and 11, x64 and Arm64.

Where is my token stored?

On your machine, encrypted with DPAPI, with your own Google OAuth client.

What does it cost?

It is open source under MIT; no price is listed.

Is NexusAGYmail free?

Yes. NexusAGYmail is open source, so you can use and self-host it for free.

How do I add NexusAGYmail to Claude Code?

Run this command in your terminal: claude mcp add nexus-agymail -- npx -y https://github.com/pironjulien/NexusAGYmail/releases/download/v0.17.1/nexus-agymail-0.17.1-win-x64.mcpb

What are the best alternatives to NexusAGYmail?

The closest alternatives to NexusAGYmail are Ha MCP, Concord MCP, note1, BoardAgent and Callout.

Alternatives to NexusAGYmail

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  5. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  6. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media