Gmail MCP

# gmail-mcp A Gmail MCP server using OAuth2 bearer token auth via the Dedalus MCP framework. ## Tools ### Messages - `gmail_list_messages` - List messages with search queries - `gmail_get_message` - Get a specific message by ID - `gmail_send_message` - Send an email - `gmail_trash_message` - Move message to trash - `gmail_untrash_message` - Remove message from trash - `gmail_modify_message` - Add/remove labels on a message ### Threads - `gmail_list_threads` - List email threads (conversations) - `gmail_get_thread` - Get a thread with all messages - `gmail_trash_thread` - Move thread to trash ### Labels - `gmail_list_labels` - List all labels - `gmail_get_label` - Get label details - `gmail_create_label` - Create a new label - `gmail_delete_label` - Delete a user label ### Drafts - `gmail_list_drafts` - List draft emails - `gmail_get_draft` - Get a draft by ID - `gmail_create_draft` - Create a draft - `gmail_send_draft` - Send a draft - `gmail_delete_draft` - Delete a draft ### Profile - `gmail_get_profile` - Get user's Gmail profile ## Authentication Gmail API requires OAuth2. The access token is provided at runtime via Dedalus credential exchange. Required OAuth scopes (depending on operations): - `https://www.googleapis.com/auth/gmail.readonly` - Read-only access - `https://www.googleapis.com/auth/gmail.send` - Send emails - `https://www.googleapis.com/auth/gmail.modify` - Modify messages/labels - `https://www.googleapis.com/auth/gmail.compose` - Create drafts ## Usage ### Prerequisites 1. A Dedalus API key (`dsk-live-*` or `dsk-test-*`) 2. The `dedalus-labs` Python SDK installed ### Environment Variables ```bash DEDALUS_API_KEY=dsk-live-your-key-here DEDALUS_API_URL=https://api.dedaluslabs.ai DEDALUS_AS_URL=https://as.dedaluslabs.ai ``` ### Example Client See [`src/_client.py`](src/_client.py) for a complete example client that handles the OAuth browser flow. The first time you use the MCP server, you'll be prompted to authorize Gmail access via OAuth. ### OAuth Flow 1. On first request, you'll receive an `AuthenticationError` with a `connect_url` 2. Open the URL in a browser to authorize Gmail access 3. After authorization, retry the request - credentials are now stored 4. Subsequent requests will work without re-authorization ## Local Development ```bash cd gmail-mcp uv sync uv run python src/main.py ``` ## API Reference - [Gmail API Overview](https://developers.google.com/workspace/gmail/api/guides) - [Gmail API Reference](https://developers.google.com/workspace/gmail/api/reference/rest)