{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_vbvax7pdzpks","handle":"claude-gmail-mcp","url":"https://wellknown.network/agents/claude-gmail-mcp","links":{"self":"https://wellknown.network/agents/claude-gmail-mcp/record.json","html":"https://wellknown.network/agents/claude-gmail-mcp","markdown":"https://wellknown.network/agents/claude-gmail-mcp/record.md","api":"https://wellknown.network/api/v1/agents/claude-gmail-mcp","status":"https://wellknown.network/api/v1/agents/claude-gmail-mcp/status","claim":"https://wellknown.network/agents/claude-gmail-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/claude-gmail-mcp/claim.json","badge":"https://wellknown.network/agents/claude-gmail-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:claude-gmail-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"claude-gmail-mcp","summary":"Gmail MCP server for Claude CLI — API (OAuth) and SMTP/IMAP backends","description":"# claude-gmail-mcp\n\n[![PyPI](https://img.shields.io/pypi/v/claude-gmail-mcp)](https://pypi.org/project/claude-gmail-mcp/)\n\nA super tiny Gmail MCP server for Claude Code. Lets Claude send, search, and read Gmail on your behalf.\n\nTwo backends are supported and auto-selected at startup:\n\n- **Gmail API (OAuth)** — recommended. No app password. Batch search. Direct Gmail web URLs on every result.\n- **SMTP/IMAP (app password)** — simpler setup. Fallback when the OAuth token isn't present.\n\nI needed something for my projects — there were a bunch around which seemed super complicated. So why not have Claude CLI build one for me :-p\n\n## Prerequisites\n\n- [uv](https://docs.astral.sh/uv/getting-started/installation/) installed\n- One of:\n  - A Google Cloud OAuth client (Desktop app) — for the API backend, OR\n  - A Gmail [App Password](https://myaccount.google.com/apppasswords) — for the SMTP/IMAP backend\n\n## Install (Gmail API backend — recommended)\n\n1. In [Google Cloud Console](https://console.cloud.google.com/), create a project, enable the Gmail API, and configure the OAuth consent screen (External, add your Gmail as a test user). Create an OAuth client of type **Desktop app** and download the credentials JSON.\n2. Run the auth helper, pointing at the downloaded file:\n\n   ```sh\n   uvx --from claude-gmail-mcp claude-gmail-mcp-auth /path/to/credentials.json\n   ```\n\n   Browser opens → sign in → approve (scope: `gmail.modify`). Refresh token is saved to `~/.config/claude-gmail-mcp/token.json` (perms `600`).\n3. Register the MCP server with Claude Code (no env vars needed):\n\n   ```sh\n   claude mcp add gmail --scope user -- uvx claude-gmail-mcp\n   ```\n\n## Install (SMTP/IMAP backend — fallback)\n\n```sh\nclaude mcp add gmail --scope user \\\n  -e GMAIL_ADDRESS=you@gmail.com \\\n  -e GMAIL_APP_PASSWORD=your-app-password \\\n  -- uvx claude-gmail-mcp\n```\n\nReplace `you@gmail.com` and `your-app-password` with your actual credentials. Drop `--scope user` to install only for the current project dir…","publisher":null,"homepage":"https://github.com/pliablepixels/claude-gmail-mcp","repository":"https://github.com/pliablepixels/claude-gmail-mcp","version":"0.2.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:claude-gmail-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"productivity.email","name":"Email","confidence":1,"provenance":"derived"},{"slug":"security.identity","name":"Identity & Access","confidence":0.745,"provenance":"derived"}],"categories":["productivity","security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"claude-gmail-mcp","registry":"pypi","observedAt":"2026-09-09T11:35:12.073Z","publishedAt":"2026-04-18T14:08:11.922985Z","latestVersion":"0.2.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"claude-gmail-mcp","url":"https://pypi.org/project/claude-gmail-mcp/","firstSeenAt":"2026-09-09T11:30:50.186Z","fetchedAt":"2026-09-09T11:30:50.186Z","normalizedAt":"2026-09-09T11:30:50.186Z"}]},"firstSeenAt":"2026-09-09T11:30:50.186Z","updatedAt":"2026-09-09T11:35:12.073Z"}