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