Gmail MCP Server

by shubhiscoding

243 downloads

Not rated

GitHub

Communication

Description

# Gmail MCP Server A Model Context Protocol (MCP) server for Gmail integration, built with [FastMCP](https://github.com/punkpeye/fastmcp). This server provides AI assistants with the ability to interact with Gmail through a set of standardized tools. ## Overview This project…

About

Details

Author: shubhiscoding
Downloads: 243
Categories: Communication

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Gmail MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "gmail mcp server": {
            "gmail-mcp": {
                "command": "bash",
                "args": [
                    "-c",
                    "cd ~Your-Path-To-The-Repo/Gmail-MCP-Server && npm run start"
                ],
                "disabled": false
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gmail mcp server": {
            "gmail-mcp": {
                "command": "bash",
                "args": [
                    "-c",
                    "cd ~Your-Path-To-The-Repo/Gmail-MCP-Server && npm run start"
                ],
                "disabled": false
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gmail mcp server": {
            "gmail-mcp": {
                "command": "bash",
                "args": [
                    "-c",
                    "cd ~Your-Path-To-The-Repo/Gmail-MCP-Server && npm run start"
                ],
                "disabled": false
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "gmail mcp server": {
            "gmail-mcp": {
                "command": "bash",
                "args": [
                    "-c",
                    "cd ~Your-Path-To-The-Repo/Gmail-MCP-Server && npm run start"
                ],
                "disabled": false
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gmail mcp server": {
            "gmail-mcp": {
                "command": "bash",
                "args": [
                    "-c",
                    "cd ~Your-Path-To-The-Repo/Gmail-MCP-Server && npm run start"
                ],
                "disabled": false
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gmail mcp server": {
            "gmail-mcp": {
                "command": "bash",
                "args": [
                    "-c",
                    "cd ~Your-Path-To-The-Repo/Gmail-MCP-Server && npm run start"
                ],
                "disabled": false
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "gmail mcp server": {
            "gmail-mcp": {
                "command": "bash",
                "args": [
                    "-c",
                    "cd ~Your-Path-To-The-Repo/Gmail-MCP-Server && npm run start"
                ],
                "disabled": false
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gmail mcp server": {
            "gmail-mcp": {
                "command": "bash",
                "args": [
                    "-c",
                    "cd ~Your-Path-To-The-Repo/Gmail-MCP-Server && npm run start"
                ],
                "disabled": false
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gmail mcp server": {
            "gmail-mcp": {
                "command": "bash",
                "args": [
                    "-c",
                    "cd ~Your-Path-To-The-Repo/Gmail-MCP-Server && npm run start"
                ],
                "disabled": false
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "gmail mcp server": {
            "gmail-mcp": {
                "command": "bash",
                "args": [
                    "-c",
                    "cd ~Your-Path-To-The-Repo/Gmail-MCP-Server && npm run start"
                ],
                "disabled": false
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gmail mcp server": {
            "gmail-mcp": {
                "command": "bash",
                "args": [
                    "-c",
                    "cd ~Your-Path-To-The-Repo/Gmail-MCP-Server && npm run start"
                ],
                "disabled": false
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gmail mcp server": {
            "gmail-mcp": {
                "command": "bash",
                "args": [
                    "-c",
                    "cd ~Your-Path-To-The-Repo/Gmail-MCP-Server && npm run start"
                ],
                "disabled": false
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "gmail mcp server": {
            "gmail-mcp": {
                "command": "bash",
                "args": [
                    "-c",
                    "cd ~Your-Path-To-The-Repo/Gmail-MCP-Server && npm run start"
                ],
                "disabled": false
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gmail mcp server": {
            "gmail-mcp": {
                "command": "bash",
                "args": [
                    "-c",
                    "cd ~Your-Path-To-The-Repo/Gmail-MCP-Server && npm run start"
                ],
                "disabled": false
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gmail mcp server": {
            "gmail-mcp": {
                "command": "bash",
                "args": [
                    "-c",
                    "cd ~Your-Path-To-The-Repo/Gmail-MCP-Server && npm run start"
                ],
                "disabled": false
            }
        }
    }
}

From the repository

Clone the repository, run npm install, create a .env file with GMAIL_USER and GMAIL_APP_PASSWORD, then start with npm run dev. Configure the server in mcp_config.json for Windsurf or Claude Desktop.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "gmail mcp server": {
            "gmail-mcp": {
                "command": "bash",
                "args": [
                    "-c",
                    "cd ~Your-Path-To-The-Repo/Gmail-MCP-Server && npm run start"
                ],
                "disabled": false
            }
        }
    }
}

McpServers

{
    "gmail-mcp": {
        "command": "bash",
        "args": [
            "-c",
            "cd ~Your-Path-To-The-Repo/Gmail-MCP-Server && npm run start"
        ],
        "disabled": false
    }
}

Gmail MCP Server

A Model Context Protocol (MCP) server for Gmail integration, built with FastMCP. This server provides AI assistants with the ability to interact with Gmail through a set of standardized tools.

Overview

This project implements an MCP server that allows AI assistants to perform various Gmail operations including:

- Fetching emails from your inbox
- Searching emails by subject
- Searching emails from specific senders
- Retrieving unread emails
- Sending emails to recipients

The server uses IMAP for email retrieval and SMTP for sending emails, all secured through Gmail's authentication system.

Setup

1. Clone the repository

git clone https://github.com/shubhiscoding/Gmail-MCP-Server
cd gmail-mcp

2. Install dependencies

npm install

3. Create a .env file in the root directory with the following variables:

GMAIL_USER=your_gmail_address
GMAIL_APP_PASSWORD=your-app-password

To generate an App Password for your Gmail account:
1. Go to your Google Account > Security
2. Enable 2-Step Verification if not already enabled
3. Go to App passwords
4. Select "Mail" and your device
5. Click "Generate"

Usage

Starting the Server

Start the server in development mode:

npm run dev

Configuration to run with Windsurf

Configure ``mcp_config.json`to add gmail-mcp server:

{

  "mcpServers": {

    "gmail-mcp": {

      "command": "bash",

      "args": [

        "-c",

        "cd ~Your-Path-To-The-Repo/Gmail-MCP-Server && npm run start"

      ],

      "disabled": false

    }

  }

}


Configuration to run with Claude desktop on Windows
{
  "mcpServers": {
    "gmail-mcp": {
      "command": "cmd",
      "args": ["/c", "cd /d ~Your-Path-To-The-Repo\\Gmail-MCP-Server && npm run start"]
    }
  }
}

Video Demo
Windsruf demo
https://github.com/user-attachments/assets/0c45ec24-be45-4271-b7d0-fc6cd58b850f
Claude Desktop Demo
https://github.com/user-attachments/assets/ad1650e8-bcc4-481e-ab95-eaefd8de7472
Available Tools
The server provides the following tools for AI assistants:
1. fetchEmails
Fetches emails from your inbox with optional filtering.

Parameters: -limit(optional): Maximum number of emails to fetch (default: 10) -mailbox(optional): Mailbox to fetch emails from (default: 'INBOX') -searchCriteria (optional): IMAP search criteria (default: ['ALL'])


2. fetchEmailsBySubject
Fetches emails with a specific subject.

Parameters: -subject: Subject to search for -limit (optional): Maximum number of emails to fetch (default: 10)


3. fetchEmailsFromSender
Fetches emails from a specific sender.

Parameters: -sender: Email address of the sender -limit (optional): Maximum number of emails to fetch (default: 10)


4. fetchUnreadEmails
Fetches unread emails from your inbox.

Parameters: -limit (optional): Maximum number of emails to fetch (default: 10)


5. sendEmails
Sends an email to a specified recipient.

Parameters: -to: Email address of the recipient -subject: Subject of the email -body: Body of the email


Security

This server uses environment variables to store sensitive information like your Gmail credentials. Never commit your .env` file to version control.

Technical Details

The project is built with:
- TypeScript for type safety
- Node.js IMAP and Nodemailer libraries for email operations
- FastMCP for MCP server implementation
- dotenv for environment variable management

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Description

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Gmail MCP Server

Overview

Setup

Usage

Starting the Server

Configuration to run with Windsurf

Configuration to run with Claude desktop on Windows

Video Demo

Windsruf demo

Claude Desktop Demo

Available Tools

1. fetchEmails

2. fetchEmailsBySubject

3. fetchEmailsFromSender

4. fetchUnreadEmails

5. sendEmails

Security

Technical Details

Install

More like this

Slack

Inbox Zero

Production-ready MCP integrations for AI applications

whatsapp-mcp

Apple Native Tools

WeChat Summarizer