Developers

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

  1. Create a key in Vithos → Settings → Account → API keys.
  2. Keep Read selected; add Write or Send only when needed.
  3. 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.