Gmail for your AI agent

Give Claude Code, Cursor, Codex or your own agent Gmail through one MCP URL and one key. Your team signs in to Gmail once and the agent never holds a token. Reads run at once; anything that changes Gmail waits for your approval.

Get your key Read the docs

61: Gmail actions your agent gets as tools
1 URL: one endpoint, one key per agent
60/min: calls per key, hard caps on top
0: Gmail credentials inside your agent

Actions

What your agent can do in Gmail

A sample of the 61 actions. Your agent sees the full list with tools/list.

Reads · run at once

Fetch emails
Fetch message by message ID
Fetch Message by Thread ID
Get Gmail attachment
Get Auto-Forwarding Settings
Get contacts
Get Draft
Get Gmail filter

Writes · wait for your approval

Modify email labels
Batch delete Gmail messages
Batch modify Gmail messages
Create email draft
Create Gmail filter
Create label
Delete Draft
Delete Gmail filter

Quickstart

Connect Gmail to your agent in two minutes

Create your account and connect Gmail with its normal sign-in page.
Open Developers and create an agent key (you can limit it to Gmail).
Add the server to your client:

Claude Code · Terminal

claude mcp add --transport http vellarin https://hub.vellarin.ai/api/hub/mcp --header "Authorization: Bearer <key>"

Cursor · ~/.cursor/mcp.json (or .cursor/mcp.json in a project)

{
  "mcpServers": {
    "vellarin": {
      "url": "https://hub.vellarin.ai/api/hub/mcp",
      "headers": {
        "Authorization": "Bearer ${env:VELLARIN_HUB_KEY}"
      }
    }
  }
}

Codex · ~/.codex/config.toml

[mcp_servers.vellarin]
url = "https://hub.vellarin.ai/api/hub/mcp"
bearer_token_env_var = "VELLARIN_HUB_KEY"

Questions

Gmail and AI agents

How do I connect Gmail to Claude Code, Cursor or Codex?

Create a free Vellarin account, connect Gmail with its normal sign-in, create an agent key on the Developers page and add the Vellarin Hub MCP server to your client with one line. Your agent then sees the Gmail actions as tools.

Can my agent change things in Gmail without asking me?

No. Read actions run at once. Any action that sends, creates, changes or deletes something in Gmail waits for the workspace owner's approval and then runs exactly once.

Does my agent get my Gmail password or token?

No. The sign-in lives on the server side. Your agent holds only a Vellarin Hub key, which you can scope to Gmail alone, cap per day and per month, and revoke at any moment.

What does it cost?

Hub Free includes 500 app calls a month and 1 agent key, with no card. Over the cap the answer is "upgrade or wait", never a charge.