gmail-mcp-server

torresmateo/gmail-mcp-server

3.1

If you are the rightful owner of gmail-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This server facilitates the integration of Gmail functionalities into applications using the Model Context Protocol (MCP) framework.

Adaptation of https://github.com/jasonsum/gmail-mcp-server for cursor

Requirements

  • Setup a Google Project and enable the Gmail API.
  • Configure an OAuth consent screen, and set it to "external". Add your own gmail as a test user.
  • Under "Data Access", enable the ".../auth/gmail.modify" scope, which allows the app to "Read, compose, and send emails from your Gmail account"
  • Make a "Desktop app" client and download the credentials as json to a known, secure location.

Add the server to Cursor

uv --directory /Users/mateo/Arcade/mcp-gmail-server/ run gmail --credentials /Users/mateo/Arcade/mcp-gmail-server/google-credentials.json --token /Users/mateo/Arcade/mcp-gmail-server/mcp-tokens.json

Here, variables are:

  • --directory (the path to this repo)
  • --credentials (the path to a credentials file downloaded from Google Console)
  • --token (the path to a file where access and refresh tokens will be stored)

All paths should be absolute paths