Gmail MCP Server

A Model Context Protocol (MCP) server that integrates Gmail with Claude Desktop, enabling Claude to access and understand email content while maintaining proper context management and privacy controls.

Features

Gmail API integration with OAuth2 authentication
Secure token management and storage
Privacy-focused data handling
Context window management for Claude
Comprehensive logging and error handling
Docker support for easy deployment

Prerequisites

Node.js >= 18.0.0
npm or yarn
Google Cloud Project with Gmail API enabled
Claude API key

Setup

Clone the repository:

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

Install dependencies:

npm install

Create a .env file in the root directory with the following variables:

GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
GOOGLE_REDIRECT_URI=http://localhost:3000/auth/google/callback
CLAUDE_API_KEY=your_claude_api_key
PORT=3000

Start the development server:

npm run dev

Development

npm run dev: Start the development server with hot reloading
npm test: Run tests
npm run lint: Run ESLint

Project Structure

gmail-mcp-server/
├── src/
│   ├── server.js          # Main server entry point
│   ├── auth.js            # Authentication handling
│   ├── gmail.js           # Gmail API integration
│   ├── claude.js          # Claude API integration
│   ├── logger.js          # Logging configuration
│   └── utils/             # Utility functions
├── tests/                 # Test files
├── .env                   # Environment variables
├── .gitignore            # Git ignore rules
├── package.json          # Project dependencies
└── README.md             # Project documentation

Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Integrations