# NexusAGYmail

> NexusAGYmail is an open-source MCP server for communication. Local Gmail server for Google Antigravity that sends drafts only after your yes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, self-hosted
- **Website:** https://julienpiron.fr/nexusagymail/
- **Repository:** https://github.com/pironjulien/nexusagymail
- **MCP Registry name:** io.github.pironjulien/nexus-agymail
- **Categories:** communication, productivity
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.

---
Source: https://ai-powered.com/mcp/nexusagymail
