Skip to main content
Glama

Gmail MCP Server

by cskiro

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

  1. Clone the repository:
git clone https://github.com/yourusername/gmail-mcp-server.git cd gmail-mcp-server
  1. Install dependencies:
npm install
  1. 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
  1. 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

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

License

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

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An integration server that allows Claude Desktop to securely access and process Gmail content while maintaining proper context management and privacy controls.

  1. Features
    1. Prerequisites
      1. Setup
        1. Development
          1. Project Structure
            1. Contributing
              1. License

                Related MCP Servers

                • A
                  security
                  A
                  license
                  A
                  quality
                  Model Context Protocol server for Gmail integration. This allows Claude Desktop (or any MCP client) to interact with your Gmail account through Google Apps Script.
                  Last updated -
                  3
                  7
                  8
                  JavaScript
                  MIT License
                  • Apple
                • -
                  security
                  A
                  license
                  -
                  quality
                  Server for Gmail integration in Claude Desktop with auto authentication support. This server enables AI assistants to manage Gmail through natural language interactions.
                  Last updated -
                  57,424
                  283
                  JavaScript
                  MIT License
                  • Linux
                  • Apple
                • -
                  security
                  A
                  license
                  -
                  quality
                  A server that allows Claude to search and retrieve emails from your Gmail account, supporting functions like searching emails, retrieving full content of specific emails, and listing recent messages.
                  Last updated -
                  2
                  Python
                  Apache 2.0
                • -
                  security
                  F
                  license
                  -
                  quality
                  An integration server that provides Claude Desktop access to Gmail, enabling users to view recent emails and search their Gmail inbox using natural language commands.
                  Last updated -
                  6
                  Python

                View all related MCP servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/cskiro/gmail-mcp-server'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server