# 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
