KosmoKrator

communication

Gmail MCP Gateway for AI Agents

Expose Gmail tools to Claude Code, Cursor, Codex, and other MCP clients through the local KosmoKrator MCP gateway.

16 functions 9 read 7 write OAuth browser flow auth
Submit Gmail feedback View package source

Gmail MCP Gateway

Expose Gmail to MCP clients with `kosmokrator mcp:serve --integration=gmail`.

If the client has never used KosmoKrator before, install it first, then register this integration as a stdio MCP server. The gateway exposes only the selected integration in the example below. 

curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash
kosmokrator mcp:gateway:install --integration=gmail --write=deny --json
{
  "mcpServers": {
    "kosmokrator-gmail": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=gmail",
        "--write=deny"
      ]
    }
  }
}

Serve Manually

kosmokrator mcp:serve --integration=gmail --write=deny

MCP Tool Names

KosmoKrator exposes integration tools through the gateway with stable names:

MCP Tool Names (16 tools)
MCP toolSource functionType
integration__gmail__gmail_add_labels gmail.gmail_add_labels Write write
integration__gmail__gmail_archive gmail.gmail_archive Read read
integration__gmail__gmail_create_draft gmail.gmail_create_draft Write write
integration__gmail__gmail_mark_read gmail.gmail_mark_read Write write
integration__gmail__gmail_mark_unread gmail.gmail_mark_unread Write write
integration__gmail__gmail_read gmail.gmail_read Read read
integration__gmail__gmail_remove_labels gmail.gmail_remove_labels Write write
integration__gmail__gmail_reply gmail.gmail_reply Read read
integration__gmail__gmail_count_by_sender gmail.gmail_count_by_sender Read read
integration__gmail__gmail_list_labels gmail.gmail_list_labels Read read
integration__gmail__gmail_save_attachment gmail.gmail_save_attachment Read read
integration__gmail__gmail_search_emails gmail.gmail_search_emails Read read
integration__gmail__gmail_send_draft gmail.gmail_send_draft Write write
integration__gmail__gmail_send_email gmail.gmail_send_email Write write
integration__gmail__gmail_trash gmail.gmail_trash Read read
integration__gmail__gmail_untrash gmail.gmail_untrash Read read

Write Access

Start with --write=deny for read-only MCP clients. Use --write=ask or --write=allow only when the client and workspace are trusted.