FastMCP FastMCP
Sign In
G

Gmail

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

17 views
0 installs
Updated Jan 4, 2026
Not audited
Productivity Communication
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).

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
317
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
413
10
1-Click Ready
G

Gmail

Remote Remote

Enterprise-grade Gmail integration with governance controls and OAuth authentication

31
0
1-Click Ready

Report Issue

Thank you! Your issue report has been submitted successfully.