Gmail 통합을 위한 모델 Context Protocol 서버. Claude Desktop (또는 MCP 클라이언트)는 Google Apps Script를 통해 Gmail 계정과 상호 작용할 수 있습니다.

빠른 시작 (사용자를 위해)

# 필수품

• Node.js 18+ ([T0]를 통해 설치)
• Gmail 계정
• Google Apps 스크립트 배포
• Claude 데스크톱 ([T1]에서 설치)

윤곽

1. Google Apps Script 배포

• Google Apps Script를 방문하여 새로운 프로젝트를 만들 수 있습니다.
• code.gs의 전체 내용을 복사하고 스크립트 편집기에 붙여넣기
• 클릭 “Deploy” > “새로운 배포”
• 배포 유형으로 "Web app"을 선택하십시오.
• 다음 설정 구성:
• 실행 : 나를
• 누구든지 접근: 누구나
• 클릭 “Deploy”
• 신속한, 검토 및 Gmail 계정에 액세스 할 응용 프로그램을 승인 할 때
• 배포 URL을 복사하고 보안을 위한 랜덤 API 키 생성

참고: 스크립트는 Gmail 액세스 권한을 요구합니다. 먼저 배포하고 스크립트를 실행하면 Google은이 권한을 검토하고 부여하도록 요청합니다. 확인하기:

1. "Review Permissions"를 클릭하십시오
2. Google 계정 선택
3. "Advanced"을 클릭하여 경고를 볼 수 있습니다.
4. "Go to [Your Project Name] (안전하지 않음)
5. 명세.

MCP Gmail

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.

Quick Start (For Users)

Prerequisites

• Node.js 18+ (install via brew install node)
• Gmail account
• Google Apps Script deployment
• Claude Desktop (install from https://claude.ai/desktop)

Configuration

1. Deploy the Google Apps Script

• Visit Google Apps Script and create a new project
• Copy the entire contents of code.gs and paste it into the script editor
• Click on “Deploy” > “New deployment”
• Select “Web app” as the deployment type
• Configure the following settings:
  • Execute as: Me
  • Who has access: Anyone
  • Click “Deploy”
• When prompted, review and authorize the app to access your Gmail account
• Copy the deployment URL and generate a random API key for security

Note: The script requires Gmail access permissions. When you first deploy and run the script, Google will ask you to review and grant these permissions. Make sure to:

1. Click “Review Permissions”

2. Select your Google account

3. Click “Advanced” if you see a warning

4. Click “Go to [Your Project Name] (unsafe)”

5. Click “Allow” to grant the necessary Gmail permissions

6. Open your Claude Desktop configuration file at: ~/Library/Application Support/Claude/claude_desktop_config.json

You can find this through the Claude Desktop menu:

1. Open Claude Desktop

2. Click Claude on the Mac menu bar

3. Click “Settings”

4. Click “Developer”

5. Add the following to your configuration:

{
  "tools": {
    "gmail": {
      "command": "npx",
      "args": ["-y", "@kazuph/mcp-gmail-gas"],
      "env": {
        "GAS_ENDPOINT": "YOUR_DEPLOYMENT_URL",
        "VALID_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Note: Replace YOUR_DEPLOYMENT_URL and YOUR_API_KEY with your actual values.

For Developers

Prerequisites

• Node.js 18+ (install via brew install node)
• Gmail account
• Google Apps Script
• Claude Desktop (install from https://claude.ai/desktop)
• tsx (install via npm install -g tsx)

Installation

git clone https://github.com/kazuph/mcp-gmail-gas.git
cd mcp-gmail-gas
npm install
npm run build

Development Configuration

1. Make sure Claude Desktop is installed and running.

2. Install tsx globally if you haven’t:

npm install -g tsx
# or
pnpm add -g tsx

3. Modify your Claude Desktop config located at: ~/Library/Application Support/Claude/claude_desktop_config.json

Add the following to your MCP client’s configuration:

{
  "tools": {
    "gmail": {
      "args": ["tsx", "/path/to/mcp-gmail-gas/index.ts"],
      "env": {
        "GAS_ENDPOINT": "YOUR_DEPLOYMENT_URL",
        "VALID_API_KEY": "YOUR_API_KEY"