Gmail
About
Integrates with Gmail's API to enable email management tasks like sending, reading, drafting, and organizing messages.
Details
- Author
- jmonsellier
- Repository
- jmonsellier/gmail-mcp-server
- License
- GNU General Public License v3.0
- Categories
- Productivity, Design, Developer Tools, AI, Communication, Infrastructure, Knowledge Base, API
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. Input: recipient_id (string), subject (string), message (string). Returns status and message_id.
trash-email
Moves email to trash. Input: email_id (string). Returns success message.
mark-email-as-read
Marks email as read. Input: email_id (string). Returns success message.
get-unread-emails
Retrieves unread emails. Returns list of emails including email ID.
read-email
Retrieves given email content. Input: email_id (string). Returns dictionary of email metadata and marks email as read.
open-email
Open email in browser. Input: email_id (string). 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": null,
"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": null,
"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": null,
"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": null,
"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.
