OAuth2 인증을 가진 Gmail API를 위한 MCP 서버. 이메일 전송, 라벨 관리, 필터 작성 및 AI 보조를 통해 첨부 파일을 처리 할 수 있도록 Gmail에 대한 programmatic 액세스를 제공합니다.

**: 이 MCP 서버는 Cursor Cloud Geminis 및 기타 IDE-integrated AI 조수와 원활하게 작동하도록 설계되었습니다. 개발 환경 내에서 직접 네이티브 이메일 관리 경험 - 응용 프로그램간에 전환 할 필요가 없습니다. 또한 Claude Desktop과 같은 데스크톱 도구와 함께 사용할 수 있지만, 기본 IDE 통합은 가장 부드러운 경험을 제공합니다.

요구 사항

• Node.js 18.0.0 이상
• Gmail API를 사용한 Google Cloud 프로젝트
• OAuth 2.0 credentials (데스크탑 신청 또는 웹 신청 유형)

빠른 시작

시작하는 가장 쉬운 방법은 설정 명령을 사용하여:

npm run setup] 명령은 자동으로:

• ✅ Cursor IDE용 MCP 구성 파일 생성
• ✅ Claude Desktop 설정 지침 제공
• ✅ 빌드 및 자격 증명을 검증

설정 후, IDE를 다시 시작하고 AI Assistant에서 Gmail을 직접 관리 시작합니다!

설치

npm에서 설치 (추천)

또는 로컬로 설치:

소스에서 설치

Gmail MCP Server

MCP server for Gmail API with OAuth2 authentication. Provides programmatic access to Gmail for sending emails, managing labels, creating filters, and handling attachments through AI assistants.

💡 Built for Your IDE: This MCP server is designed to work seamlessly with Cursor Cloud Geminis and other IDE-integrated AI assistants. Experience native email management directly within your development environment—no need to switch between applications. You can also use it with desktop tools like Claude Desktop, but the native IDE integration provides the smoothest experience.

Requirements

• Node.js 18.0.0+
• Google Cloud Project with Gmail API enabled
• OAuth 2.0 credentials (Desktop application or Web application type)

Quick Start

The easiest way to get started is using the setup command:

git clone https://github.com/pouyanafisi/gmail-mcp.git
cd gmail-mcp
npm install
npm run build
npm run setup    # Automatically configures MCP for Cursor IDE
npm run auth     # Authenticate with Gmail

The npm run setup command automatically:

• ✅ Creates the MCP configuration file for Cursor IDE
• ✅ Provides instructions for Claude Desktop setup
• ✅ Verifies your build and credentials

After setup, restart your IDE and start managing Gmail directly from your AI assistant!

Installation

Install from npm (Recommended)

npm install -g @pouyanafisi/gmail-mcp

Or install locally:

npm install @pouyanafisi/gmail-mcp

Install from source

git clone https://github.com/pouyanafisi/gmail-mcp.git
cd gmail-mcp
npm install
npm run build
npm run setup    # Automatically configures MCP for your IDE

Google Cloud Setup

1. Enable Gmail API in Google Cloud Console
2. Create OAuth 2.0 credentials (Desktop application or Web application)
3. Download credentials JSON
4. Save as gcp-oauth.keys.json in project root or ~/.gmail-mcp/

Configuration

Using npm package

If installed globally:

{
  "mcpServers": {
    "gmail": {
      "command": "gmail-mcp"
    }
  }
}

If installed locally, use npx:

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": ["-y", "gmail-mcp"]
    }
  }
}

Using source installation

{
  "mcpServers": {
    "gmail": {
      "command": "node",
      "args": ["/absolute/path/to/gmail-mcp/dist/index.js"]
    }
  }
}