Google MCP
Google MCP 도구
이는 Claude나 Cursor와 같은 AI 클라이언트와 완벽하게 통합되도록 설계된 MCP 프로토콜을 위한 Google 기본 도구(예: Gmail, 캘린더) 모음입니다.
지엑스피1
특징
지메일:
여러 수신자(받는 사람, 참조, 숨은 참조)와 첨부 파일을 포함한 이메일을 보냅니다.
사용자 정의 쿼리, 레이블 및 결과 제한을 사용하여 이메일을 나열합니다.
ID로 특정 이메일을 읽어보세요.
라벨을 관리합니다(추가, 제거, 나열).
이메일을 초안하고 삭제합니다.
달력:
달력을 나열하고 기본 달력을 설정합니다.
세부 정보(요약, 시작/종료 시간, 참석자 등)를 입력하여 이벤트를 만듭니다.
사용자 정의 필터를 사용하여 다가올 이벤트를 나열하세요.
기존 이벤트를 업데이트하거나 삭제합니다.
일정을 잡기 위한 여유 시간대를 찾으세요.
운전하다:
검색어로 필터링
수정 날짜 또는 기타 기준으로 정렬
표시 개수 사용자 정의
자세한 파일 메타데이터 보기
파일 콘텐츠(텍스트, 문서, 스프레드시트) 읽기
지정된 콘텐츠로 새 파일을 만듭니다.
기존 파일 업데이트
파일 삭제(휴지통 또는 영구)
특정 권한으로 파일 공유
작업:
모든 작업 목록 보기
새로운 작업 목록 만들기
기존 작업 목록 삭제
기본 작업 목록 설정
필터를 사용하여 작업 나열
작업 세부 정보 보기
제목, 메모, 마감일을 사용하여 작업 만들기
작업 속성 업데이트
작업을 완료로 표시
작업 삭제
TODO 계획:
Google 연락처: 연락처를 검색하고 관리하세요.
그리고 더 많은 것들...
워크플로에 대한 명령을 연결할 수 있습니다. 예:
"읽지 않은 이메일을 나열하고, 가장 최근 이메일에 대한 답장을 작성하고, 내일 오후 2시에 후속 회의를 예약하세요."
수동 설치
필수 조건:
Bun 설치:
brew install oven-sh/bun/bun # macOS/Linux with HomebrewOAuth 설정:
Google Cloud Console 에서 Google Cloud 프로젝트를 만듭니다.
OAuth 2.0 자격 증명(클라이언트 ID, 클라이언트 비밀번호)을 설정합니다.
데스크톱 앱 유형을 선택하세요.
테스트 모드를 사용하는 경우 테스트 사용자 목록에 이메일을 추가하세요.
원하는 서비스(Gmail, 캘린더, 드라이브 등)에 대한 API 액세스를 활성화하세요.
클라이언트 구성: claude_desktop_config.json(또는 클라이언트에 대한 동등한 구성 파일)을 편집하세요.
{
"mcpServers": {
"google-mcp": {
"command": "bunx",
"args": ["--no-cache", "google-mcp@latest"],
"env": {
// Either can be used, but not both
// Use OAuth
"GOOGLE_OAUTH_CLIENT_ID": "<YOUR_CLIENT_ID>",
"GOOGLE_OAUTH_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
"GOOGLE_OAUTH_TOKEN_PATH": "<PATH_TO_STORE_TOKENS>",
// Use Service Account
"GOOGLE_CLIENT_EMAIL": "<YOUR_SERVICE_ACCOUNT_EMAIL>",
"GOOGLE_PRIVATE_KEY": "<YOUR_SERVICE_ACCOUNT_PRIVATE_KEY>",
"GMAIL_USER_TO_IMPERSONATE": "<USER_TO_IMPERSONATE>"
}
}
}
}인증:
서버를 처음 실행하면 OAuth 인증을 위한 브라우저가 열립니다. 안내에 따라 액세스 권한을 부여하면 토큰이 GOOGLE_OAUTH_TOKEN_PATH에 저장됩니다.
Related MCP server: Google Search MCP Server
용법
이제 Claude에게 google-mcp 도구를 사용하라고 요청해 보세요.
Send an email to jane.doe@example.com with the subject "Meeting Notes" and body "Here are the notes from today."List my upcoming calendar events for the next 3 days.Create a calendar event titled "Team Sync" tomorrow at 10 AM for 1 hour.지역 개발
git clone https://github.com/vakharwalad23/google-mcp.git
cd google-mcp
bun install
bun run index.tsGoogle MCP 도구를 사용해 주셔서 감사합니다! 질문이나 제안 사항이 있으시면 언제든지 이슈를 개설하거나 프로젝트에 참여해 주세요.
도구를 이용해 놀아보며 즐겨보세요!!
Available Tools
32 toolsgoogle_calendar_create_eventC
Create a new event in Google Calendar
Inputs: end (required), start (required), summary (required), attendees, +5 more.
google_calendar_delete_eventC
Delete an event from Google Calendar
Inputs: eventId (required), calendarId.
google_calendar_find_free_timeC
Find available time slots between events
Inputs: duration (required), endDate (required), startDate (required), calendarIds.
google_calendar_get_eventC
Get detailed information about a specific event
Inputs: eventId (required), calendarId.
google_calendar_get_eventsC
Retrieve upcoming events from Google Calendar
Inputs: calendarId, limit, q, showDeleted, +2 more.
google_calendar_list_calendarsB
List all available calendars
Inputs: no named parameters.
google_calendar_set_defaultC
Set the default calendar ID for operations
Inputs: calendarId (required).
google_calendar_update_eventC
Update an existing event in Google Calendar
Inputs: eventId (required), attendees, calendarId, colorId, +6 more.
google_drive_create_fileC
Create a new file in Google Drive
Inputs: content (required), name (required), folderId, mimeType.
google_drive_delete_fileC
Delete a file from Google Drive
Inputs: fileId (required), permanently.
google_drive_get_file_contentC
Get the content of a file from Google Drive
Inputs: fileId (required).
google_drive_list_filesC
List files from Google Drive
Inputs: fields, orderBy, pageSize, query.
google_drive_update_fileC
Update the content of an existing file in Google Drive
Inputs: content (required), fileId (required), mimeType.
google_gmail_delete_emailC
Delete or trash an email
Inputs: messageId (required), permanently.
google_gmail_draft_emailC
Create a draft email
Inputs: body (required), subject (required), to (required), bcc, +2 more.
google_gmail_get_emailB
Get detailed information about a specific email
Inputs: messageId (required), format.
google_gmail_get_email_by_indexB
Get email by its index from the most recent search results
Inputs: index (required), format.
google_gmail_list_emailsC
List emails from a specific label or folder
Inputs: labelIds, maxResults, query.
google_gmail_list_labelsB
List all available Gmail labels
Inputs: no named parameters.
google_gmail_modify_labelsC
Add or remove labels from an email
Inputs: messageId (required), addLabelIds, removeLabelIds.
google_gmail_send_emailC
Send a new email
Inputs: body (required), subject (required), to (required), bcc, +2 more.
google_tasks_complete_taskC
Mark a task as completed
Inputs: taskId (required), taskListId.
google_tasks_create_taskC
Create a new task
Inputs: title (required), due, notes, taskListId.
google_tasks_create_tasklistC
Create a new task list
Inputs: title (required).
google_tasks_delete_taskC
Delete a task
Inputs: taskId (required), taskListId.
google_tasks_delete_tasklistC
Delete a task list
Inputs: taskListId (required).
google_tasks_get_taskC
Get details about a specific task
Inputs: taskId (required), taskListId.
google_tasks_list_tasklistsB
List all available task lists
Inputs: no named parameters.
google_tasks_list_tasksC
List tasks from a task list
Inputs: showCompleted, taskListId.
google_tasks_set_default_listC
Set the default task list ID for operations
Inputs: taskListId (required).
google_tasks_update_taskC
Update an existing task
Inputs: taskId (required), due, notes, status, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 32 tools
Every tool has a clearly distinct purpose with no ambiguity, as each is scoped to a specific Google service (Calendar, Drive, Gmail, Tasks) and a specific action on a resource (e.g., create, delete, list). Overlap is minimal, such as 'google_calendar_get_event' and 'google_calendar_get_events' being clearly differentiated by singular vs. plural.
Tool names follow a highly consistent verb_noun pattern throughout, with a clear structure: 'google_service_action_resource' (e.g., 'google_calendar_create_event'). All tools use snake_case uniformly, and verbs are predictable (create, delete, get, list, update, etc.), making the set easy to navigate.
With 32 tools, the count is borderline high for a single server, as it covers multiple Google services (Calendar, Drive, Gmail, Tasks). While each service is well-scoped individually, the overall set feels heavy and might be better split into separate servers, but it's not extreme (e.g., not 50+ tools).
The tool surface provides complete CRUD/lifecycle coverage for each Google service domain, with no obvious gaps. For example, Calendar has create, get, list, update, delete, plus utilities like find_free_time; Gmail includes send, draft, get, list, delete, and label management; ensuring agents can handle full workflows without dead ends.
Related MCP Connectors
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
Hosted Google Calendar MCP server for AI agents. No self-hosting or Google Cloud setup.
Read and edit GA4, Search Console and Google Tag Manager from any MCP client. 29 tools.
The OpenRouter for tools. One MCP connection gives any AI agent 254 hosted tools, pay per call.
Related MCP Servers
- AlicenseAqualityBmaintenanceThis server enables users to perform Google News searches with automatic categorization and multi-language support via SerpAPI integration.4191 npm131MIT
- FlicenseNot gradedqualityCmaintenanceAn MCP (Model Context Protocol) server that provides Google search capabilities and webpage content analysis tools. This server enables AI models to perform Google searches and analyze webpage content programmatically.262-
- FlicenseNot gradedqualityDmaintenanceA locally-hosted MCP server that integrates Gmail, Google Calendar, and Google Drive to provide AI-powered management of emails, events, and files. It enables tool-based interactions like sending emails, creating calendar events, and searching Drive files through clients like Cursor and Claude Desktop.-
- AlicenseAqualityCmaintenanceMCP server for Google APIs — Gmail and Calendar tools for LLM agents.62MIT