gogcli-mcp-gmail

Extended Gmail MCP server via gogcli — 32 tools: auth + 4 base Gmail + 23 extra dedicated Gmail tools.

• Source: github.com/chrischall/gogcli-mcp

Requirements

• gogcli installed and authenticated
• Node.js 18 or later

Setup

{
  "mcpServers": {
    "gogcli-gmail": {
      "command": "npx",
      "args": ["-y", "gogcli-mcp-gmail"],
      "env": {
        "GOG_ACCOUNT": "you@gmail.com"
      }
    }
  }
}

Extra Gmail Tools

Read

| Tool | What it does | |------|-------------| | gog_gmail_raw | Raw Gmail API JSON for a message | | gog_gmail_attachment | Download a single attachment | | gog_gmail_url | Print web URLs for threads | | gog_gmail_history | List history events since a historyId |

Threads

| Tool | What it does | |------|-------------| | gog_gmail_thread_get | Get a thread with all messages | | gog_gmail_thread_modify | Modify labels on a thread | | gog_gmail_thread_attachments | List/download all attachments in a thread |

Labels

| Tool | What it does | |------|-------------| | gog_gmail_labels_list | List all labels | | gog_gmail_labels_get | Get a label's details and counts | | gog_gmail_labels_create | Create a new label | | gog_gmail_labels_rename | Rename a label | | gog_gmail_labels_delete | Delete a label | | gog_gmail_labels_modify | Modify labels on one or more threads |

Bulk operations

| Tool | What it does | |------|-------------| | gog_gmail_archive | Archive by IDs or query | | gog_gmail_mark_read | Mark read by IDs or query | | gog_gmail_mark_unread | Mark unread by IDs or query | | gog_gmail_trash | Trash by IDs or query | | gog_gmail_message_modify | Modify labels on a single message | | gog_gmail_batch_delete | Permanently delete multiple messages | | gog_gmail_batch_modify | Modify labels on multiple messages |

Drafts

| Tool | What it does | |------|-------------| | gog_gmail_drafts_list | List drafts | | gog_gmail_drafts_get | Get a draft | | gog_gmail_drafts_create | Create a draft | | gog_gmail_drafts_update | Update a draft | | gog_gmail_drafts_delete | Delete a draft | | gog_gmail_drafts_send | Send a draft |

Write

| Tool | What it does | |------|-------------| | gog_gmail_forward | Forward a message | | gog_gmail_autoreply | Reply once to all messages matching a query |

Plus 5 auth tools and 4 base Gmail tools (search, get, send, run). Use gog_gmail_run for advanced settings (filters, delegates, forwarding, sendas, vacation, watch) and email tracking (track).