{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_m22havhm3e93","handle":"gmail-multi-user-mcp","url":"https://wellknown.network/agents/gmail-multi-user-mcp","links":{"self":"https://wellknown.network/agents/gmail-multi-user-mcp/record.json","html":"https://wellknown.network/agents/gmail-multi-user-mcp","markdown":"https://wellknown.network/agents/gmail-multi-user-mcp/record.md","api":"https://wellknown.network/api/v1/agents/gmail-multi-user-mcp","status":"https://wellknown.network/api/v1/agents/gmail-multi-user-mcp/status","claim":"https://wellknown.network/agents/gmail-multi-user-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/gmail-multi-user-mcp/claim.json","badge":"https://wellknown.network/agents/gmail-multi-user-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:gmail-multi-user-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"gmail-multi-user-mcp","summary":"Multi-user Gmail integration library and MCP server","description":"# gmail-multi-user-mcp\n\nMulti-user Gmail integration library and MCP server for AI agents and consumer applications.\n\n## Features\n\n- **Hybrid Distribution**: Use as a Python library or MCP server\n- **Multi-User OAuth**: End-users authenticate with their own Gmail accounts\n- **Automatic Token Management**: Encryption, refresh, and storage handled automatically\n- **Full Gmail Operations**: Search, read, send, draft, labels, attachments\n- **Flexible Storage**: SQLite for development, Supabase for production\n\n## Quick Start\n\n### Installation\n\n```bash\npip install gmail-multi-user-mcp\n```\n\n### Configuration\n\n1. Create a Google Cloud Project and enable the Gmail API\n2. Create OAuth 2.0 credentials (Desktop or Web application)\n3. Copy `gmail_config.yaml.example` to `gmail_config.yaml`\n4. Fill in your credentials\n\n### Usage as Library\n\n```python\nfrom gmail_multi_user import GmailClient\n\n# Initialize client (loads config automatically)\nclient = GmailClient()\n\n# Generate OAuth URL for a user\nresult = client.get_auth_url(user_id=\"user_123\")\nprint(f\"Please visit: {result.auth_url}\")\n\n# After OAuth callback, search emails\nmessages = client.search(\n    connection_id=\"conn_abc\",\n    query=\"is:unread\"\n)\n\nfor msg in messages.messages:\n    print(f\"{msg.subject} from {msg.from_.email}\")\n```\n\n### Usage as MCP Server\n\n```bash\n# Start the MCP server\ngmail-mcp serve\n\n# Or with HTTP transport\ngmail-mcp serve --transport http --port 8000\n```\n\n## Development\n\n```bash\n# Install with dev dependencies\npip install -e \".[dev]\"\n\n# Run tests\npytest\n\n# Run linting\nruff check .\nblack --check .\nmypy gmail_multi_user gmail_mcp_server\n```\n\n## License\n\nMIT","publisher":null,"homepage":"https://gmail-multi-user-mcp.readthedocs.io","repository":"https://github.com/yourorg/gmail-multi-user-mcp/blob/main/CHANGELOG.md","version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["ai-agents","email","gmail","mcp","model-context-protocol","oauth"],"pricing":null,"endpoints":[{"url":"pypi:gmail-multi-user-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"derived"},{"slug":"productivity.email","name":"Email","confidence":1,"provenance":"declared"},{"slug":"security.identity","name":"Identity & Access","confidence":1,"provenance":"declared"}],"categories":["data","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":"gmail-multi-user-mcp","registry":"pypi","observedAt":"2026-09-09T16:25:32.899Z","publishedAt":"2026-01-12T20:31:38.911326Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"gmail-multi-user-mcp","url":"https://pypi.org/project/gmail-multi-user-mcp/","firstSeenAt":"2026-09-09T16:24:12.163Z","fetchedAt":"2026-09-09T16:24:12.163Z","normalizedAt":"2026-09-09T16:24:12.163Z"}]},"firstSeenAt":"2026-09-09T16:24:12.163Z","updatedAt":"2026-09-09T16:25:32.899Z"}