Jasonsum Gmail MCP Server

🚀 Gmail Server for Model Context Protocol (MCP)

This MCP server integrates with Gmail to enable sending, deleting, reading, composing, and responding to emails.

⚠️ Important Note

This server enables MCP clients to read, delete, and send emails. However, the client will prompt the user before performing such activities.

Related Link

✨ Features

Tools

• send-email

  • Send an email to the recipient's address.
  • Input:
    • recipient_id (string): The recipient's email address.
    • subject (string): The subject of the email.
    • message (string): The content of the email.
  • Returns the status and message ID.

• trash-email

  • Move an email to the trash.
  • Input:
    • email_id (string): The automatically generated email ID.
  • Returns a success message.

• mark-email-as-read

  • Mark an email as read.
  • Input:
    • email_id (string): The automatically generated email ID.
  • Returns a success message.

• get-unread-emails

  • Retrieve unread emails.
  • Returns a list of unread emails, including email IDs.

• read-email

  • Retrieve the content of a given email.
  • Input:
    • email_id (string): The automatically generated email ID.
  • Returns a dictionary containing email metadata and marks the email as read.

• open-email

  • Open an email in the browser.
  • Input:
    • email_id (string): The automatically generated email ID.
  • Returns a success message and opens the specified email in the default browser.

📦 Installation

Gmail API Setup

1. Create a new Google Cloud project.
2. Enable the Gmail API.
3. Configure the OAuth consent screen.
   • Select "External". However, we will not publish this application.
   • Add your personal email address as a "Test user".
4. Add the OAuth scope https://www.googleapis.com/auth/gmail/modify.
5. Create an OAuth client ID of the application type and select "Desktop application".
6. Download the JSON file of your client's OAuth key.
7. Rename the key file and save it to a secure location on your local computer. Remember this path.
   • When starting the server, this path will be returned via the parameter --creds.

Authentication

Run the following command for authentication:

python -m gmail_mcp --creds path/to/your/credentials.json

This will open a default browser window to complete Google's OAuth process. After completion, you will see a success message, and a crets.json file will be created at the path/to/your/credentials.json location.

Now you can use the Gmail MCP server!