Claude 데스크톱, 커서 또는 어떤 MCP 클라이언트를 Google 문서, Google 시트, Google Drive, Gmail, Google 캘린더에 연결하세요.

---

퀵 스타트

1. Google Cloud OAuth 클라이언트 만들기

1. 구글 클라우드 콘솔로 이동
2. 프로젝트 생성 또는 선택
3. Google Docs API, Google Sheets API, Google Drive API, Gmail API, Google Calendar API를 활성화하세요
4. OAuth 동의 화면 설정 (외부에서 이메일을 테스트 사용자로 추가하고, 문서/시트/드라이브 범위 옆에 gmail.modify와 calendar.events 범위를 추가하세요)
5. OAuth 클라이언트 ID (데스크톱 앱 유형) 생성
6. 확인 화면에서 클라이언트 ID와 클라이언트 비밀을 복사합니다

더 자세한 내용이 필요하신가요? 이 페이지 하단의 단계별 지침을 참고하세요.

2. 승인

이렇게 하면 구글 인증을 위해 브라우저가 열립니다. 승인 후 새로고침 토큰이 ~/.config/google-docs-mcp/token.json에 저장됩니다.

3. MCP 클라이언트에 추가하세요

Claude 데스크탑 / 커서 / 윈드서핑:

MCP 클라이언트가 필요할 때 서버가 자동으로 시작됩니다.

원격 배포 (클라우드 런)

팀에 한 번 배포하면 로컬 설치가 필요 없습니다. 서버는 MCP OAuth 2를 사용합니다.

Google Docs, Sheets, Drive, Gmail & Calendar MCP Server

Connect Claude Desktop, Cursor, or any MCP client to your Google Docs, Google Sheets, Google Drive, Gmail, and Google Calendar.

---

Quick Start

1. Create a Google Cloud OAuth Client

1. Go to the Google Cloud Console
2. Create or select a project
3. Enable the Google Docs API, Google Sheets API, Google Drive API, Gmail API, and Google Calendar API
4. Configure the OAuth consent screen (External, add your email as a test user, and add the gmail.modify and calendar.events scopes alongside the Docs/Sheets/Drive scopes)
5. Create an OAuth client ID (Desktop app type)
6. Copy the Client ID and Client Secret from the confirmation screen

Need more detail? See step-by-step instructions at the bottom of this page.

2. Authorize

GOOGLE_CLIENT_ID="your-client-id" \
GOOGLE_CLIENT_SECRET="your-client-secret" \
npx -y @a-bonus/google-docs-mcp auth

This opens your browser for Google authorization. After you approve, the refresh token is saved to ~/.config/google-docs-mcp/token.json.

3. Add to Your MCP Client

Claude Desktop / Cursor / Windsurf:

{
  "mcpServers": {
    "google-docs": {
      "command": "npx",
      "args": ["-y", "@a-bonus/google-docs-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

The server starts automatically when your MCP client needs it.

Remote Deployment (Cloud Run)

Deploy once for your team – no local installs required. The server uses MCP OAuth 2.1 so your MCP client handles authentication automatically.

gcloud run deploy google-docs-mcp \
  --source . \
  --region europe-west3 \
  --port 8080 \
  --allow-unauthenticated \
  --set-env-vars "^|^MCP_TRANSPORT=httpStream|BASE_URL=https://your-service.run.app|GOOGLE_CLIENT_ID=...|GOOGLE_CLIENT_SECRET=...|TOKEN_STORE=firestore|JWT_SIGNING_KEY=your-secret-key"

Then each user just adds the URL to their MCP client – no npx, no tokens, no local setup:

{
  "mcpServers": {
    "google-docs": {
      "type": "streamableHttp",
      "url": "https://your-service.run.app/mcp"
    }
  }
}

Your MCP client will prompt for Google sign-in on first connection. See Remote Deployment for details.

---

What Can It Do?

Tools across Google Docs, Sheets, and Drive:

Google Docs