MCP Gmail Server

A Model Context Protocol (MCP) server for integrating Gmail with Claude and other MCP-compatible AI assistants.

🚀 Features

• List emails: Retrieve emails from your inbox

• Send emails: Compose and send emails

• Email management: Delete, archive, mark as read

• Batch operations: Process multiple emails in a single operation

• Label management: List and move emails to specific labels

Related MCP server: Google Tasks MCP Server

📋 Prerequisites

• Node.js 18 or higher

• A Google account with Gmail API enabled

• OAuth2 credentials (Client ID, Client Secret)

🔧 Installation

1. Clone the repository:

2. Install dependencies:

3. Configure your OAuth2 credentials (see Configuration section)

⚙️ Configuration

Step 1: Create a Google Cloud Project

1. Go to Google Cloud Console

2. Create a new project or select an existing one

3. Enable the Gmail API for your project

4. Go to "Credentials" and create an OAuth2 Client ID

5. Application type: "Desktop app"

6. Important: Add http://localhost:3000 to the authorized redirect URIs

Step 2: Get the Refresh Token

Run the authentication script:

Follow the on-screen instructions to:

1. Enter your Client ID

2. Enter your Client Secret

3. Authorize access in your browser

4. Retrieve your Refresh Token

Step 3: Configure Environment Variables

Create a .env file at the project root:

🎯 Usage with Claude Desktop

1. Add the server to your Claude Desktop configuration (claude_desktop_config.json):

2. Restart Claude Desktop

📚 Available Tools

list_emails

List emails from inbox

• maxResults: Maximum number of emails (default: 10)

• query: Gmail search query (optional)

send_email

Send an email

• to: Recipient email address

• subject: Email subject

• body: Email body

delete_email

Delete an email

• id: Email ID

archive_email

Archive an email

• id: Email ID

mark_as_read

Mark an email as read

• id: Email ID

Batch Operations

• delete_emails_batch: Delete multiple emails

• archive_emails_batch: Archive multiple emails

• mark_as_read_batch: Mark multiple emails as read

Label Management

• list_labels: List all available labels

• move_to_label: Move an email to a label

• move_to_label_batch: Move multiple emails to a label

🛠️ Useful Scripts

📁 Project Structure

🔒 Security

• Never share your OAuth2 credentials

• The .env file is automatically ignored by Git

• Use minimal permissions for the Gmail API

📝 License

MIT - See the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Feel free to open an issue or pull request.

🐛 Troubleshooting

If you encounter issues:

1. Verify that the Gmail API is enabled in your Google Cloud project

2. Ensure redirect URIs include http://localhost:3000

3. Check that your refresh token is valid

📧 Contact

Julien Renaud - GitHub