# Gmail MCP Server

MCP server for Gmail integration with Claude Code.

## Setup

### 1. Create Google Cloud Credentials

1. Go to [Google Cloud Console](https://console.cloud.google.com/)
2. Create a new project (or select existing)
3. Enable the **Gmail API**
4. Go to **Credentials** → **Create Credentials** → **OAuth 2.0 Client ID**
5. Application type: **Desktop app**
6. Download the JSON file
7. Rename to `credentials.json` and place in this folder

### 2. Install Dependencies

```bash
cd D:\Projects\gmail-mcp
pip install -r requirements.txt
```

### 3. First-time Authentication

Run once to authorize:
```bash
python server.py
```
This will open a browser for OAuth consent. After authorizing, a `token.json` file is created.

### 4. Add to Claude Code

Add to your MCP settings (`%APPDATA%\Claude\claude_desktop_config.json` or VS Code settings):

```json
{
  "mcpServers": {
    "gmail": {
      "command": "python",
      "args": ["D:\\Projects\\gmail-mcp\\server.py"]
    }
  }
}
```

## Tools

| Tool | Description |
|------|-------------|
| `get_todays_emails` | Get all emails from today |
| `get_emails` | Get emails with optional search query |
| `get_email` | Get full email by ID |
| `search_emails` | Advanced email search |
| `mark_as_read` | Mark emails as read |
| `send_email` | Send an email |
| `get_labels` | List Gmail labels |

## Security

Do not commit these files:
- `credentials.json` - OAuth client credentials
- `token.json` - Your auth token