# MCP Gmail Server

A server that uses model context protocol[https://modelcontextprotocol.io/] to read and create drafts of emails from Gmail.

## Project setup

### Create Oauth client and add secrets:

**Create a Google Cloud Project**
1. Go to **[https://console.cloud.google.com/](https://console.cloud.google.com/)**
2. In the top-left, open the project dropdown and click **New Project**
3. Give your project a name (e.g., *Gmail API Demo*)
4. Click **Create**
Your project is now created; make sure it’s selected in the project dropdown.

**Enable the Gmail API**
1. Go to the **API Library**:
   [https://console.cloud.google.com/apis/library](https://console.cloud.google.com/apis/library)
2. Search for **Gmail API**
3. Click it → **Enable**

**Configure OAuth 2.0 Credentials**
1. Navigate to:
   **APIs & Services → Credentials**
2. You’ll be prompted to configure the **OAuth Consent Screen** (if first time creating OAuth credentials)
3. Choose **External** if users outside your Google Workspace will use it
4. Fill in details
5. Add test users (email addresses allowed to authorize during development)
6. Save the configuration

1. Click **Create Credentials** → **OAuth client ID**
2. Choose the application type: **Desktop app** (for testing/dev)
3. Name it
4. Click **Create**

You will now receive:
* **Client ID**
* **Client Secret**
Download them as JSON for use in your code.

Save the JSON as
"client_secret_oauth_gcp.json" in the root of this project. 
(note this should be stored securely and not commited to github.)

### Install and run app

Install uv:
https://docs.astral.sh/uv/getting-started/installation/

Install dependencies with uv:
```uv sync```

Start server:
```uv run -m src.mcp_server_gmail```

### Claude desktop

Install Claude Desktop

Set `claude_desktop_config.json` file to:
```
{
  "mcpServers": {
    "gmail": {
      "command": "/Users/myname/Documents/Coding/fac-mcp-gmail-server/.venv/bin/python",
      "args": [
        "-m",
        "mcp_server_gmail"
      ],
      "env": {
        "PYTHONPATH": "/Users/myname/Documents/Coding/fac-mcp-gmail-server/src"
      },
      "cwd": "/Users/myname/Documents/Coding/fac-mcp-gmail-server"
    }
  }
}
```
Ensuring the directory paths are replaced appropriately with your local directory paths.

### Test (manual)

Go to claude desktop

Try the following:
"Get last 3 unread emails"
"Create draft emails for these" 

See `/docs/working_examples`, for examples screenshots of the mcp server

## Features
- Gmail Oauth set up
- MCP server for read and drafting emails on gmail