Your agent, your inbox

Vithos exposes live Gmail through a versioned REST API and a Streamable HTTP MCP server. Keys are scoped, revocable, and read-only unless you explicitly grant Write or Send.

Connect Cursor or Claude

Create a key in Vithos: Settings, Account, API keys.
Keep Read selected; add Write or Send only when needed.
Add this server to your MCP configuration.

{
  "mcpServers": {
    "vithos": {
      "url": "https://api.vithos.app/mcp",
      "headers": {
        "x-api-key": "lm_live_YOUR_KEY"
      }
    }
  }
}

MCP endpoint: https://api.vithos.app/mcp. API and MCP access require Pro.

REST API

The public surface is versioned under /v1. The OpenAPI document is generated from the same Zod schemas used by MCP tools.

curl "https://api.vithos.app/v1/search?q=invoice&limit=10" \
  -H "x-api-key: lm_live_YOUR_KEY"

OpenAPI 3.1 document

Permission model

Read: Search mail, read threads, labels, and Waiting On.
Write: Create drafts, change labels, and add follow-ups.
Send: Send email. Never included on a default key.