Gongrzhe Gmail MCP Server

🚀 Gmail Auto Authentication MCP Server

A Model Context Protocol (MCP) server for the desktop version of Claude integrated with Gmail, supporting automatic authentication. This server enables AI assistants to manage Gmail through natural language interaction.

🚀 Quick Start

This is a Model Context Protocol (MCP) server for the desktop version of Claude integrated with Gmail. It supports automatic authentication, allowing AI assistants to manage Gmail through natural - language interaction.

✨ Features

• Send emails with subject, content, attachments, and recipients.
• Read email messages by ID.
• Search for emails using various criteria (subject, sender, date range).
• List emails in the inbox, sent items, or custom labels.
• Mark emails as read/unread.
• Move emails to different labels/folders.
• Fully integrated with the Gmail API.
• Simple OAuth2 authentication process with support for automatic browser launch.
• Support for both desktop and web versions.
• Securely store credentials locally.

📦 Installation

Install using Smithery CLI

smith install @gongrzhe/server-gmail-autoauth-mcp

Manual Installation

1. Clone this repository:

   git clone https://github.com/yourusername/gmail-autoauth-mcp.git
   cd gmail-autoauth-mcp
   

2. Install dependencies:

   npm install
   

3. Start the server:

   node index.js
   

💻 Usage Examples

Configure Gmail Credentials

Add the following content to the config.json file:

{
  "gmail": {
    "clientId": "your_client_id",
    "clientSecret": "your_client_secret",
    "redirectUri": "http://localhost:3000"
  }
}

Authorize Gmail Account

Run the following command to authorize your Gmail account:

node authorize.js

Follow the prompts to complete the OAuth process.

Basic Usage

Send an Email

{
  "to": ["recipient@example.com"],
  "subject": "Meeting Tomorrow",
  "body": "Hi,\n\nJust a reminder about our meeting tomorrow at 10 AM.\n\nBest regards",
  "cc": ["cc@example.com"],
  "bcc": ["bcc@example.com"]
}

Search for Emails

{
  "query": "from:sender@example.com after:2024/01/01",
  "maxResults": 10
}

Read an Email

{
  "messageId": "message123"
}

Move an Email

{
  "messageId": "message123",
  "labelIds": ["INBOX", "IMPORTANT"]
}

🔧 Technical Details

Security Precautions

• OAuth credentials are securely stored in the local environment (~/.gmail-mcp).
• The server uses offline access to maintain persistent authentication.
• Never share or commit your credentials to version control.
• Regularly check and revoke unused Google account permissions.
• Credentials are stored globally but are only accessible to the current user.

Troubleshooting

1. OAuth Keys Not Found
   • Ensure that gcp-oauth.keys.json is in the current directory or ~/.gmail-mcp/.
   • Check file permissions.
2. Invalid Credential Format
   • Ensure that your OAuth credential file contains web or installed credentials.
   • For web applications, verify that the redirect URI is correctly configured.
3. Port Already in Use
   • If port 3000 is already in use, release it.
   • You can find and stop the process using that port.

🤝 Contribution

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is released under the ISC license.

🆘 Support

If you encounter any problems or have any questions, please submit an issue in the GitHub repository.