
NexusAGYmail
Local Gmail server for Google Antigravity that sends drafts only after your yes
- 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.mcpbAdd 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"
]
}
}
}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"
]
}
}
}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-agymailNEXUS_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-agymailNEXUS_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

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media