Gmail
About
Integrates with Gmail API to enable email operations like sending, managing labels, and searching messages.
Details
- Author
- jasonsum
- Repository
- jasonsum/gmail-mcp-server
- GitHub stars
- 61
- License
- GNU General Public License v3.0
- Categories
- Productivity, Developer Tools, Design, AI, Search, Frontend, API, Communication
- Tags
- #integration
Jump to
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
GmailCommand (node, npx, python, etc.)uvArguments-
Argument 1
--directory -
Argument 2
[absolute-path-to-git-repo] -
Argument 3
run -
Argument 4
gmail -
Argument 5
--creds-file-path -
Argument 6
[absolute-path-to-credentials-file] -
Argument 7
--token-path -
Argument 8
[absolute-path-to-access-tokens-file]
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
send-email
Sends email to email address recipient. Parameters: recipient_id (string), subject (string), message (string). Returns status and message_id.
trash-email
Moves email to trash. Parameters: email_id (string): Auto-generated ID of email. Returns success message.
mark-email-as-read
Marks email as read. Parameters: email_id (string): Auto-generated ID of email. Returns success message.
get-unread-emails
Retrieves unread emails. Returns list of emails including email ID.
read-email
Retrieves given email content. Parameters: email_id (string): Auto-generated ID of email. Returns dictionary of email metadata and marks email as read.
open-email
Open email in browser. Parameters: email_id (string): Auto-generated ID of email. Returns success message and opens given email in default browser.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"gmail": {
"cwd": "string",
"env": {},
"args": [
"--directory",
"[absolute-path-to-git-repo]",
"run",
"gmail",
"--creds-file-path",
"[absolute-path-to-credentials-file]",
"--token-path",
"[absolute-path-to-access-tokens-file]"
],
"shell": false,
"command": "uv"
}
}
}
Linux
{
"cwd": "string",
"env": [],
"args": [
"--directory",
"[absolute-path-to-git-repo]",
"run",
"gmail",
"--creds-file-path",
"[absolute-path-to-credentials-file]",
"--token-path",
"[absolute-path-to-access-tokens-file]"
],
"shell": false,
"command": "uv"
}
Macos
{
"cwd": "string",
"env": [],
"args": [
"--directory",
"[absolute-path-to-git-repo]",
"run",
"gmail",
"--creds-file-path",
"[absolute-path-to-credentials-file]",
"--token-path",
"[absolute-path-to-access-tokens-file]"
],
"shell": false,
"command": "uv"
}
Windows
{
"cwd": "string",
"env": [],
"args": [
"--directory",
"[absolute-path-to-git-repo]",
"run",
"gmail",
"--creds-file-path",
"[absolute-path-to-credentials-file]",
"--token-path",
"[absolute-path-to-access-tokens-file]"
],
"shell": false,
"command": "uv"
}
Gmail Server for Model Context Protocol (MCP)
This MCP server integrates with Gmail to enable sending, removing, reading, drafting, and responding to emails.
> Note: This server enables an MCP client to read, remove, and send emails. However, the client prompts the user before conducting such activities.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





