Claude Desktop은 여러 Gmail 계정을 동시에 관리할 수 있는 Model Context Protocol (MCP) 서버입니다. 공식 Anthropic MCP 등록 및 npm에 게시 됨.

---

특징

• Connectunlimited Gmail 계정 - 개인, 일, 사이드 프로젝트 -Search 전체 Gmail 검색 구문을 사용하여 어떤 inbox
• Read MIME parsing과의 완벽한 이메일
• Send, ** 스레드에 가해 **, ** 생성 초안 ** -Organize 레이블: 추가, 제거, 목록, 아카이브 -Mark 읽음 / 읽음
• ~/.gmail-mcp-tokens.db]에서 로컬로 저장되는 토큰 - git에 절대 투입되지 않음
• Auto-refreshes OAuth 토큰 조용히

---

요구 사항

• 노드.js >= 22.5.0
• Gmail API를 사용한 Google Cloud 프로젝트
• Claude 데스크탑

---

설치

이 두 개의 글로벌 명령을 등록: gmail-mcp (MCP 서버) 및 gmail-mcp-cli (계정 관리자).

---

구글 클라우드 설정

한 번만 할 필요가 있습니다.

1. console.cloud.google.com로 이동 → 프로젝트 만들기
2. Gmail API (APIs & Services → Library) 사용
3. **OAuth 동의 화면 구성 ** - 외부, 테스트 사용자로 Gmail 주소를 추가
4. 범위를 추가하십시오: gmail.readonly, gmail.send], gmail.modify], `gmail.

multi-gmail-mcp

A Model Context Protocol (MCP) server that lets Claude Desktop manage multiple Gmail accounts simultaneously. Listed on the official Anthropic MCP registry and published on npm.

---

Features

• Connect unlimited Gmail accounts — personal, work, side projects
• Search any inbox using full Gmail search syntax
• Read complete emails with MIME parsing
• Send, reply in thread, and create drafts
• Organize with labels: add, remove, list, archive
• Mark as read / unread
• Tokens stored locally in ~/.gmail-mcp-tokens.db — never committed to git
• Auto-refreshes OAuth tokens silently

---

Requirements

• Node.js >= 22.5.0
• A Google Cloud project with the Gmail API enabled
• Claude Desktop

---

Installation

npm install -g multi-gmail-mcp

This registers two global commands: gmail-mcp (the MCP server) and gmail-mcp-cli (account manager).

---

Google Cloud Setup

You only need to do this once.

1. Go to console.cloud.google.com → create a project
2. Enable the Gmail API (APIs & Services → Library)
3. Configure the OAuth consent screen — External, add your Gmail addresses as test users
4. Add scopes: gmail.readonly, gmail.send, gmail.modify, gmail.labels
5. Create a Desktop app OAuth credential → download the JSON
6. Save it to ~/.gmail-mcp-oauth.json

Alternatively, set environment variables in the Claude Desktop config (see below).

---

Authenticating Gmail Accounts

# Add accounts (opens browser for Google sign-in)
gmail-mcp-cli add [email protected]
gmail-mcp-cli add [email protected]

# List authenticated accounts
gmail-mcp-cli list

# Remove an account
gmail-mcp-cli remove [email protected]

Tokens are saved to ~/.gmail-mcp-tokens.db and refreshed automatically.

---

Claude Desktop Configuration

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

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

If you prefer environment variables over ~/.gmail-mcp-oauth.json:

{
  "mcpServers": {
    "multi-gmail": {
      "command": "gmail-mcp",
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Restart Claude Desktop after saving. Click the hammer icon to confirm 19 tools are loaded.

---

Available Tools

Account Management

Reading Email