G

Gmail

Integrates with Gmail to enable natural language-based email management, including searching, readin...

168 views
0 installs
Updated Jan 4, 2026
Not audited
Integrates with Gmail to enable natural language-based email management, including searching, reading, deleting, and sending emails with attachment support and conversation threading.
  1. Get the Systemprompt API key

    1. Open the Systemprompt console at systemprompt.io/console and sign in (or create an account). (systemprompt.io)
    2. In the console look for an "API Keys" or "Create API Key" area, create a new key, and copy the key to your clipboard. (Save it somewhere safe; you will paste it into FastMCP in a later step.) (systemprompt.io)
  2. Create Google Cloud credentials (GOOGLE_CREDENTIALS) for Gmail access

    1. Open the Google Cloud Console and either select an existing project or create a new one. (cloud.google.com)
    2. Enable the Gmail API for that project (APIs & Services → Library → search “Gmail API” → Enable). (developers.google.com)
    3. Configure the OAuth consent screen (Google Auth / OAuth consent) — set app name, user support email, user type (External for personal/testing use), and add any test users if required. (ai.google.dev)
    4. Create OAuth 2.0 credentials: go to OAuth Clients (Credentials → Create Client → choose “Desktop app”), create the client, then download the JSON credentials file (rename to something like client_secret.json). This file is your Google credentials JSON. (ai.google.dev)
  3. Generate the Google OAuth token file (GOOGLE_TOKEN)

    1. Use the google-auth helper included in the multimodal-mcp-client repository to run the OAuth flow and produce a token JSON (the repository includes a scripts/google-auth README with the exact commands). Clone or download the repo and follow the instructions in scripts/google-auth to run the authorization script and obtain the token JSON. (github.com)
    2. (If you prefer) you can follow Google’s Gmail quickstart / OAuth examples to perform the installed-app OAuth flow and save the resulting token JSON (token.json). (developers.google.com)
  4. Base64-encode the two JSON files

    1. On macOS / Linux:
      • Credentials: base64 client_secret.json > client_secret.json.b64
      • Token: base64 token.json > token.json.b64
    2. On PowerShell (Windows):
      • Credentials: [Convert]::ToBase64String([IO.File]::ReadAllBytes("client_secret.json")) > client_secret.json.b64
      • Token: [Convert]::ToBase64String([IO.File]::ReadAllBytes("token.json")) > token.json.b64
    3. Open each .b64 file and copy the full base64 string (no newlines ideally; if your tooling adds newlines it still usually works but a single-line base64 string is safest).
  5. Fill the FastMCP connection interface (use the “Install Now” button you already have)

    1. Open the FastMCP connection interface and click the "Install Now" / add ENVs action.
    2. Add an environment variable for the Systemprompt API key:
      • Key name: (as required by the server; if the server README only says “API KEY”, use the FastMCP field for API Key or a variable named e.g. SYSTEMPROMPT_API_KEY) — paste the API key you copied in step 1. (systemprompt.io)
    3. Add an environment variable named GOOGLE_CREDENTIALS and paste the base64 string produced from your credentials JSON (from step 4). (ai.google.dev)
    4. Add an environment variable named GOOGLE_TOKEN and paste the base64 string produced from your token JSON (from step 4). (developers.google.com)
    5. Save/confirm the connection settings in FastMCP. The MCP server should now have the encoded credentials/token and the Systemprompt API key available.
  6. Post-setup notes & security

    1. Keep your API key, credentials JSON, and token JSON private — treat them like passwords. Do not commit them to source control. (systemprompt.io)
    2. The token JSON often contains a refresh token; if you re-run the auth script it may overwrite the token — keep backups if you need to preserve access for multiple environments. (developers.google.com)
    3. If you have trouble with the multimodal-mcp-client helper, open the repo’s scripts/google-auth README for exact commands and troubleshooting. (github.com)

If you want, tell me the exact field names shown in your FastMCP interface (or paste a screenshot of that form) and I’ll produce the exact text you should paste into each field (including a copy-paste–safe single-line base64 example).

How to Install Gmail

Install Gmail MCP server with one click through FastMCP. Choose your preferred AI development tool below:

Claude Desktop

Click "Claude Desktop" in Quick Start

Cursor IDE

Click "Cursor IDE" in Quick Start

VS Code

Click "VS Code" in Quick Start

Alternatives to Gmail

Looking for similar MCP servers? Browse other servers in the same categories on FastMCP, or check out the similar servers listed above.

Quick Start

View on GitHub

More for Productivity

View All →

More for Communication

View All →

Similar MCP Servers

G

Gmail

Integrates Gmail functionality, enabling email search, message retrieval, and attachment downloads via Google Apps Script.

Productivity Communication
494
0
G

Gmail

Manage your emails effortlessly with a standardized interface for drafting, sending, retrieving, and organizing messages. Streamline your email workflow with complete Gmail API coverage, including label and thread management.

Communication
G

Gmail

Remote Remote

Enterprise-grade Gmail integration with governance controls and OAuth authentication

Report Issue

Thank you! Your issue report has been submitted successfully.

Stay ahead of the MCP ecosystem

Get the top new MCP servers, trending tools, and dev tips delivered weekly. Free, no spam, unsubscribe anytime.

Join 2,847 developers. We send one email per week.