# Gmail Assistant MCP
MCP server that integrates with Gmail to fetch unread emails and generate draft emails using Claude.
Also connects with a Google Doc file that outlines my writing style and useful context.
## How it works
There's 3 toosl to use:
- Ask Claude to fetch emails
- Ask Claude to draft replies to any of those emails (where you are the "to" (not "cc"))
- Ask Claude to fetch last 10 emails and draft replies for ones where they are "to" you
## Requirements
- Python 3.10+
- Gmail account with App Password enabled
- Anthropic API key
- Google Cloud project with Docs API enabled (optional, for guidelines)
## Installation
1. Clone the repo
2. Create an activate virtual environment
```bash
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
```
3. Install dependencies
4. Set up Gmail App Password (via https://myaccount.google.com/security)
5. Set up Google Docs API for guidelines (via https://console.cloud.google.com/)
a. Create a project
b. Enable Google Docs API
c. Create credentials
d. Download credentials as `credentials.json` in project root
## Configuration
Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
```json
{
"mcpServers": {
"gmail-assistant": {
"command": "/path/to/gmail-assistant-mcp/venv/bin/python",
"args": ["/path/to/gmail-assistant-mcp/src/gmail_assistant/server.py"],
"env": {
"EMAIL_USER": "your.email@gmail.com",
"EMAIL_APP_PASSWORD": "your-app-password",
"ANTHROPIC_API_KEY": "your-anthropic-api-key",
"GUIDELINES_DOC_ID": "your-google-doc-id-optional"
}
}
}
}
```
