Google MCP의 Model Context Protocol (MCP) 구현은 표준화 된 인터페이스를 통해 Google 서비스와 상호 작용하는 AI 모델을 가능하게합니다.

필수품

• 이동 1.23.2 이상
• 다음 API를 사용하여 Google Cloud Platform 계정 :
• Google 캘린더 API
• Gmail API
• 구글 채팅 API
• Google Cloud 자격 증명 (OAuth 2.0 클라이언트 ID)

설치

이동을 통해 설치

1. 서버 설치:

2. .env] 파일을 구성:

https://developers.google.com/workspace/chat/authenticate-authorize-chat-user

3. Claude의 설정 구성:

사용 도구

ENABLE_TOOLS] 환경변수는 도구 그룹의 comma-separated 목록입니다. 유효한 그룹은:

• calendar - Google 캘린더 도구
• gmail - Gmail 도구
• gchat - Google 채팅 도구

모든 도구를 사용할 수 있습니다.

사용 가능한 도구

그룹: 달력

캘린더 create event

제목, 설명, 시간, 참석자와 Google 캘린더에서 새로운 이벤트를 만듭니다.

캘린더 list events

customizable time range와 result limit를 가진 Google Calendar에 있는 다가오는 사건을 목록으로 만드십시오.

달력 update event

Google MCP - Model Context Protocol (MCP) Server

The Model Context Protocol (MCP) implementation in Google MCP enables AI models to interact with Google services through a standardized interface.

Prerequisites

• Go 1.23.2 or higher
• Google Cloud Platform account with the following APIs enabled:
  • Google Calendar API
  • Gmail API
  • Google Chat API
• Google Cloud credentials (OAuth 2.0 Client ID)

Installation

Installing via Go

1. Install the server:

go install github.com/nguyenvanduocit/google-mcp@latest

2. Create a .env file with your configuration:

# Required for Google Services
GOOGLE_CREDENTIALS_FILE=  # Required: Path to Google Cloud credentials JSON file
GOOGLE_TOKEN_FILE=       # Required: Path to store Google OAuth tokens

# Optional configurations
ENABLE_TOOLS=           # Optional: Comma-separated list of tool groups to enable (empty = all enabled)
PROXY_URL=             # Optional: HTTP/HTTPS proxy URL if needed

https://developers.google.com/workspace/chat/authenticate-authorize-chat-user

3. Configure your Claude’s config:

{
  "mcpServers": {
    "google_mcp": {
      "command": "google-mcp",
      "args": ["-env", "/path/to/.env"]
    }
  }
}

Enable Tools

The ENABLE_TOOLS environment variable is a comma-separated list of tool groups to enable. Available groups are:

• calendar - Google Calendar tools
• gmail - Gmail tools
• gchat - Google Chat tools

Leave it empty to enable all tools.

Available Tools

Group: calendar

calendar_create_event

Create a new event in Google Calendar with title, description, time, and attendees.

calendar_list_events

List upcoming events in Google Calendar with customizable time range and result limit.

calendar_update_event

Update an existing event’s details including title, description, time, and attendees.

calendar_respond_to_event

Respond to an event invitation (accept, decline, or tentative).

Group: gchat

gchat_list_spaces

List all available Google Chat spaces/rooms.

gchat_send_message

Send a message to a Google Chat space or direct message.

Group: gmail

gmail_search

Search emails in Gmail using Gmail’s search syntax.

gmail_move_to_spam

Move specific emails to spam folder in Gmail by message IDs.

gmail_create_filter

Create a Gmail filter with specified criteria and actions:

• Filter by sender, recipient, subject, or custom query
• Add labels
• Mark as important
• Mark as read
• Archive messages

gmail_list_filters

List all Gmail filters in the account.

gmail_list_labels

List all Gmail labels in the account.

gmail_delete_filter

Delete a Gmail filter by its ID.

gmail_delete_label

Delete a Gmail label by its ID.

CLI Usage

In addition to the MCP server, google-mcp ships a standalone CLI binary (google-cli) for direct terminal use — no MCP client needed.

Installation

just install-cli
# or