v2.0.0 - Initial Release

🎉 Initial Release

Complete Gmail MCP server implementation for AI assistants and IDE integration.

✨ Features

19 Operations Available:

• Email Operations (10): Send, draft, read, search, count, modify, delete, download attachments, batch modify, batch delete
• Label Management (5): List, create, update, delete, get or create labels
• Filter Management (5): Create, list, get, delete filters, plus template-based filter creation

Key Capabilities:

• ✅ OAuth2 authentication with automatic token refresh
• ✅ Batch operations with rate limit handling
• ✅ Full attachment support (send and download)
• ✅ Native IDE integration (Cursor, Claude Desktop, Gemini)
• ✅ TypeScript with strict mode
• ✅ Automatic setup script (

gmail-mcp@2.0.0 setup
node setup-mcp.js

🔧 Gmail MCP Server Setup

Server path: /Users/pouyanafisi/Sites/gmail-mcp/gmail-mcp/dist/index.js
Credentials location: ~/.gmail-mcp/credentials.json

✅ Credentials found at: /Users/pouyanafisi/.gmail-mcp/credentials.json

Creating Cursor configuration...
✅ Created: /Users/pouyanafisi/Sites/gmail-mcp/gmail-mcp/.cursor/mcp.json

Claude Desktop configuration:
📝 Location: /Users/pouyanafisi/Library/Application Support/Claude/claude_desktop_config.json
⚠️ Claude Desktop config exists but Gmail server not configured
Add this to your Claude Desktop config:
{
"mcpServers": {
"gmail": {
"command": "node",
"args": [
"/Users/pouyanafisi/Sites/gmail-mcp/gmail-mcp/dist/index.js"
]
}
}
}

📋 Summary:
✅ Cursor config created at: /Users/pouyanafisi/Sites/gmail-mcp/gmail-mcp/.cursor/mcp.json
📝 Claude Desktop: Edit manually at: /Users/pouyanafisi/Library/Application Support/Claude/claude_desktop_config.json
🔑 Credentials: /Users/pouyanafisi/.gmail-mcp/credentials.json

✨ Setup complete! Restart your IDE/AI assistant to use the Gmail MCP server.)

• ✅ Comprehensive documentation

🚀 Quick Start

npm install -g gmail-mcp
# or
git clone https://github.com/pouyanafisi/gmail-mcp.git
cd gmail-mcp
npm install
npm run build
npm run setup
npm run auth

📚 Documentation

• README.md - Complete setup and usage guide
• MCP_SETUP.md - Platform-specific setup instructions
• CLAUDE.md - Usage guidelines for Claude
• GEMINI.md - Usage guidelines for Gemini

🛠️ Built With

• MCP SDK v2
• TypeScript 5.3
• Google APIs (Gmail)
• OAuth2 authentication

Perfect for managing Gmail through AI assistants in your IDE!