Skip to main content
Glama

Google MCP 도구

대장간 배지

이는 Claude나 Cursor와 같은 AI 클라이언트와 완벽하게 통합되도록 설계된 MCP 프로토콜을 위한 Google 기본 도구(예: Gmail, 캘린더) 모음입니다.

지엑스피1

특징

  • 지메일:

    • 여러 수신자(받는 사람, 참조, 숨은 참조)와 첨부 파일을 포함한 이메일을 보냅니다.

    • 사용자 정의 쿼리, 레이블 및 결과 제한을 사용하여 이메일을 나열합니다.

    • ID로 특정 이메일을 읽어보세요.

    • 라벨을 관리합니다(추가, 제거, 나열).

    • 이메일을 초안하고 삭제합니다.

  • 달력:

    • 달력을 나열하고 기본 달력을 설정합니다.

    • 세부 정보(요약, 시작/종료 시간, 참석자 등)를 입력하여 이벤트를 만듭니다.

    • 사용자 정의 필터를 사용하여 다가올 이벤트를 나열하세요.

    • 기존 이벤트를 업데이트하거나 삭제합니다.

    • 일정을 잡기 위한 여유 시간대를 찾으세요.

  • 운전하다:

    • 검색어로 필터링

    • 수정 날짜 또는 기타 기준으로 정렬

    • 표시 개수 사용자 정의

    • 자세한 파일 메타데이터 보기

    • 파일 콘텐츠(텍스트, 문서, 스프레드시트) 읽기

    • 지정된 콘텐츠로 새 파일을 만듭니다.

    • 기존 파일 업데이트

    • 파일 삭제(휴지통 또는 영구)

    • 특정 권한으로 파일 공유

  • 작업:

    • 모든 작업 목록 보기

    • 새로운 작업 목록 만들기

    • 기존 작업 목록 삭제

    • 기본 작업 목록 설정

    • 필터를 사용하여 작업 나열

    • 작업 세부 정보 보기

    • 제목, 메모, 마감일을 사용하여 작업 만들기

    • 작업 속성 업데이트

    • 작업을 완료로 표시

    • 작업 삭제

  • TODO 계획:

    • Google 연락처: 연락처를 검색하고 관리하세요.

    • 그리고 더 많은 것들...

워크플로에 대한 명령을 연결할 수 있습니다. 예:

"읽지 않은 이메일을 나열하고, 가장 최근 이메일에 대한 답장을 작성하고, 내일 오후 2시에 후속 회의를 예약하세요."

수동 설치

  1. 필수 조건:

    • Bun 설치:

    brew install oven-sh/bun/bun  # macOS/Linux with Homebrew
  2. OAuth 설정:

    • Google Cloud Console 에서 Google Cloud 프로젝트를 만듭니다.

    • OAuth 2.0 자격 증명(클라이언트 ID, 클라이언트 비밀번호)을 설정합니다.

    • 데스크톱 앱 유형을 선택하세요.

    • 테스트 모드를 사용하는 경우 테스트 사용자 목록에 이메일을 추가하세요.

    • 원하는 서비스(Gmail, 캘린더, 드라이브 등)에 대한 API 액세스를 활성화하세요.

  3. 클라이언트 구성: 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>"
      }
    }
  }
}
  1. 인증:

    • 서버를 처음 실행하면 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.ts

Google MCP 도구를 사용해 주셔서 감사합니다! 질문이나 제안 사항이 있으시면 언제든지 이슈를 개설하거나 프로젝트에 참여해 주세요.

도구를 이용해 놀아보며 즐겨보세요!!

Available Tools

32 tools
google_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_share_fileC

Share a file with another user

Inputs: emailAddress (required), fileId (required), message, role, +1 more.

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

    B3.2/5.0

    Scored across 32 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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).

    Completeness5/5

    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

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      An 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
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      -