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.

Claude Desktop이 적절한 컨텍스트 관리 및 개인정보 보호 제어를 유지하면서 Gmail 콘텐츠에 안전하게 액세스하고 처리할 수 있도록 해주는 통합 서버입니다.

  1. 특징
    1. 필수 조건
      1. 설정
        1. 개발
          1. 프로젝트 구조
            1. 기여하다
              1. 특허

                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
                  618
                  12
                  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 -
                  3,714
                  589
                  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 -
                  5
                  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 -
                  7
                  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