mcp-server-gmail

[](https://github.com/franciscpd/mcp-server-gmail/actions/workflows/ci.yml) [](https://www.npmjs.com/package/@franciscpd/gmail-mcp-server) [](https://opensource.org/licenses/MIT)

A Model Context Protocol (MCP) server for Gmail. Read, search, send, reply, forward emails and manage labels — powered by 3 environment variables.

npx -y @franciscpd/gmail-mcp-server

Set these environment variables:

| Variable | Description | |----------|-------------| | GMAIL_CLIENT_ID | OAuth2 client ID from Google Cloud Console | | GMAIL_CLIENT_SECRET | OAuth2 client secret | | GMAIL_REFRESH_TOKEN | OAuth2 refresh token (see Setup Guide) |

1. Go to Google Cloud Console
2. Create a new project (or select an existing one)
3. Note your project name for the next steps

1. Navigate to APIs & Services → Library
2. Search for "Gmail API"
3. Click Enable

1. Navigate to APIs & Services → Credentials
2. Click Create Credentials → OAuth client ID
3. If prompted, configure the OAuth consent screen:

• User type: External (or Internal for Workspace)
• Add the scope: https://mail.google.com/
• Add your email as a test user

1. Application type: Web application
2. Add https://developers.google.com/oauthplayground as an authorized redirect URI
3. Save your Client ID and Client Secret

1. Go to Google OAuth2 Playground
2. Click the ⚙️ gear icon (top right) and check **Use yo