Google MCP Server

A comprehensive Model Context Protocol (MCP) server for Google integration, providing access to Google Calendar, Docs, Sheets, Slides, Drive, Gmail, Contacts, YouTube, Tasks, Forms, Chat, and Meet.

Features

Google Forms

• Create and manage Google Forms
• Add questions (multiple choice, short answer, checkboxes, etc.)
• Add page breaks, text items, images, and videos
• List and retrieve form responses
• Update form settings (quiz mode, etc.)

Google Chat

• List, create, and manage Chat spaces
• Send, update, and delete messages
• Add and remove reactions
• Manage space members
• Thread support for conversations

Google Meet

• Create meeting spaces with access controls
• Schedule meetings via Calendar integration
• Create instant meetings
• List and access conference records
• View participant information
• Access meeting recordings and transcripts

Google Calendar

• List calendars and events
• Create, update, and delete events
• Quick add events using natural language
• Get today's events and upcoming events
• Check free/busy availability

Google Gmail

• Read, search, and list emails
• Send emails and reply to threads
• Mark as read/unread, trash messages
• List labels and organize emails

Google Contacts (People API)

• List, search, and manage contacts
• Create, update, and delete contacts
• List contact groups

Google Drive

• List, search, and browse files and folders
• Upload, download, copy, move, and delete files
• Create folders
• Rename files

Google Docs

• Create new documents with optional initial content
• Read document content
• Insert and append text
• Find and replace text
• List all documents

Google Sheets

• Create spreadsheets with multiple sheets
• Read values from ranges
• Update and append values
• Clear ranges
• Add and delete sheets
• List all spreadsheets

Google Slides

• Create and manage presentations
• Add, delete, and duplicate slides
• Add text boxes and images
• Find and replace text
• List all presentations

Google YouTube

• Search videos, channels, and playlists
• Get video and channel details
• View and manage playlists
• Get video comments
• View subscriptions and liked videos
• Rate videos

Google Tasks (Keep Alternative)

• Manage task lists (similar to Keep categories)
• Create, update, complete, and delete tasks
• Tasks support notes/descriptions (similar to Keep notes)
• Convenience "notes" tools that provide Keep-like functionality

Note: Google Keep does not have an official public API. This server uses Google Tasks API as an alternative, which provides similar note-taking capabilities through tasks with descriptions.

Installation

# Clone the repository
cd google-mcp

# Install dependencies
pnpm install

# Build the project
pnpm build

Google Cloud Setup

Before using this server, you need to set up Google Cloud credentials:

1. Create a Google Cloud Project

1. Go to Google Cloud Console
2. Create a new project or select an existing one
3. Enable the following APIs:
   • Google Calendar API
   • Google Docs API
   • Google Sheets API
   • Google Slides API
   • Google Drive API
   • Gmail API
   • People API (Contacts)
   • YouTube Data API v3
   • Google Tasks API
   • Google Forms API
   • Google Chat API
   • Google Meet REST API

2. Create OAuth 2.0 Credentials

1. Navigate to APIs & Services > Credentials
2. Click Create Credentials > OAuth client ID
3. Select Desktop app as the application type
4. Download the JSON file

3. Place Credentials File

Save the downloaded JSON file as credentials.json at the appropriate location for your platform:

Linux:

~/.config/google-mcp/credentials.json

(or $XDG_CONFIG_HOME/google-mcp/credentials.json if XDG_CONFIG_HOME is set)

macOS:

~/Library/Application Support/google-mcp/credentials.json

Windows:

%APPDATA%\google-mcp\credentials.json

(typically C:\Users\<username>\AppData\Roaming\google-mcp\credentials.json)

The file should look like:

{
  "installed": {
    "client_id": "YOUR_CLIENT_ID.apps.googleusercontent.com",
    "project_id": "your-project-id",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token",
    "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
    "client_secret": "YOUR_CLIENT_SECRET",
    "redirect_uris": ["http://localhost:3000/oauth2callback"]
  }
}

Usage with Cursor/Claude

Add to your MCP settings configuration:

{
  "mcpServers": {
    "google": {
      "command": "node",
      "args": ["/path/to/google-mcp/dist/index.js"]
    }
  }
}

Or if running from the project directory:

{
  "mcpServers": {
    "google": {
      "command": "npx",
      "args": ["tsx", "/path/to/google-mcp/src/index.ts"]
    }
  }
}

Authentication

On first use, call the google_auth tool to initiate OAuth authentication:

1. The server will provide a URL to authenticate
2. Open the URL in a browser and sign in with your Google account
3. Grant the requested permissions
4. Authentication will complete automatically

Tokens are stored locally and will be refreshed automatically:

• Linux: ~/.local/share/google-mcp/tokens.json (or $XDG_DATA_HOME/google-mcp/)
• macOS: ~/Library/Application Support/google-mcp/tokens.json
• Windows: %APPDATA%\google-mcp\tokens.json

Available Tools

Authentication

| Tool | Description | |------|-------------| | google_auth | Initiate OAuth authentication | | google_auth_status | Check authentication status | | google_auth_code | Manually set auth code | | google_logout | Log out and clear tokens |

Google Calendar

| Tool | Description | |------|-------------| | calendar_list | List all calendars | | calendar_get | Get calendar details | | calendar_list_events | List events from calendar | | calendar_get_event | Get event details | | calendar_create_event | Create new event | | calendar_update_event | Update existing event | | calendar_delete_event | Delete an event | | calendar_quick_add | Add event via natural language | | calendar_get_freebusy | Check availability | | calendar_today | Get today's events | | calendar_upcoming | Get upcoming events |

Google Gmail

| Tool | Description | |------|-------------| | gmail_get_profile | Get Gmail profile info | | gmail_list_labels | List Gmail labels | | gmail_list_messages | List emails | | gmail_get_message | Get specific email | | gmail_send | Send an email | | gmail_reply | Reply to an email | | gmail_trash | Move to trash | | gmail_mark_read | Mark as read | | gmail_mark_unread | Mark as unread | | gmail_search | Search emails | | gmail_get_unread | Get unread emails | | gmail_get_thread | Get email thread |

Google Contacts

| Tool | Description | |------|-------------| | contacts_list | List contacts | | contacts_get | Get contact details | | contacts_search | Search contacts | | contacts_create | Create contact | | contacts_delete | Delete contact | | contacts_list_groups | List contact groups |

Google Drive

| Tool | Description | |------|-------------| | drive_list_files | List files with filtering | | drive_get_file | Get file metadata | | drive_download_file | Download file content | | drive_upload_file | Upload a new file | | drive_delete_file | Delete a file | | drive_create_folder | Create a new folder | | drive_search | Search files by content | | drive_move_file | Move file to folder | | drive_copy_file | Copy a file | | drive_rename_file | Rename a file |

Google Docs

| Tool | Description | |------|-------------| | docs_create | Create a new document | | docs_read | Read document content | | docs_insert_text | Insert text at position | | docs_append_text | Append text to end | | docs_replace_text | Find and replace text | | docs_list | List all documents |

Google Sheets

| Tool | Description | |------|-------------| | sheets_create | Create spreadsheet | | sheets_get | Get spreadsheet info | | sheets_read | Read values from range | | sheets_update | Update values in range | | sheets_append | Append rows | | sheets_clear | Clear a range | | sheets_add_sheet | Add a new sheet | | sheets_delete_sheet | Delete a sheet | | sheets_list | List all spreadsheets |

Google Slides

| Tool | Description | |------|-------------| | slides_create | Create presentation | | slides_get | Get presentation | | slides_list | List presentations | | slides_add_slide | Add a slide | | slides_delete_slide | Delete a slide | | slides_add_text | Add text box | | slides_add_image | Add image | | slides_replace_text | Find/replace text | | slides_duplicate_slide | Duplicate slide |

Google YouTube

| Tool | Description | |------|-------------| | youtube_search | Search YouTube | | youtube_get_video | Get video details | | youtube_get_channel | Get channel details | | youtube_get_my_channel | Get your channel | | youtube_list_playlists | List your playlists | | youtube_get_playlist_items | Get playlist videos | | youtube_get_video_comments | Get video comments | | youtube_list_subscriptions | List subscriptions | | youtube_list_liked_videos | List liked videos | | youtube_rate_video | Like/dislike video |

Google Tasks

| Tool | Description | |------|-------------| | tasks_list_tasklists | List task lists | | tasks_create_tasklist | Create task list | | tasks_delete_tasklist | Delete task list | | tasks_list_tasks | List tasks | | tasks_create_task | Create a task | | tasks_update_task | Update a task | | tasks_delete_task | Delete a task | | tasks_complete_task | Mark task complete |

Notes (Keep-like)

| Tool | Description | |------|-------------| | notes_create | Create a quick note | | notes_list | List all notes | | notes_update | Update a note | | notes_delete | Delete a note |

Google Forms

| Tool | Description | |------|-------------| | forms_create | Create a new form | | forms_get | Get form details | | forms_update_info | Update title/description | | forms_add_question | Add a question | | forms_delete_item | Delete form item | | forms_list_responses | List form responses | | forms_get_response | Get specific response | | forms_add_page_break | Add page break | | forms_add_text | Add text item | | forms_add_image | Add image | | forms_add_video | Add YouTube video |

Google Chat

| Tool | Description | |------|-------------| | chat_list_spaces | List Chat spaces | | chat_get_space | Get space details | | chat_create_space | Create a space | | chat_delete_space | Delete a space | | chat_list_messages | List messages | | chat_get_message | Get message details | | chat_send_message | Send a message | | chat_update_message | Update a message | | chat_delete_message | Delete a message | | chat_list_members | List space members | | chat_add_member | Add a member | | chat_remove_member | Remove a member | | chat_add_reaction | Add emoji reaction |

Google Meet

| Tool | Description | |------|-------------| | meet_create_space | Create meeting space | | meet_get_space | Get space details | | meet_end_conference | End active meeting | | meet_schedule | Schedule a meeting | | meet_create_instant | Create instant meeting | | meet_get_by_event | Get meeting from event | | meet_list_upcoming | List upcoming meetings | | meet_list_conference_records | List past meetings | | meet_get_conference_record | Get meeting record | | meet_list_participants | List participants | | meet_list_recordings | List recordings | | meet_get_recording | Get recording | | meet_list_transcripts | List transcripts | | meet_get_transcript | Get transcript | | meet_list_transcript_entries | Get transcript text |

Examples

Send an Email

Use gmail_send with to "[email protected]", subject "Hello", and body "This is a test email."

Create a Calendar Event

Use calendar_create_event with summary "Team Meeting", startDateTime "2025-01-15T10:00:00-05:00", and endDateTime "2025-01-15T11:00:00-05:00"

Search YouTube

Use youtube_search with query "MCP tutorial" and type "video"

Create a Google Doc

Use docs_create with title "Meeting Notes" and content "# Weekly Meeting\n\nAttendees: ..."

Read a Spreadsheet

Use sheets_read with spreadsheetId "abc123" and range "Sheet1!A1:D10"

Search Drive

Use drive_search with query "quarterly report"

Create a Note

Use notes_create with title "Shopping List" and content "- Milk\n- Eggs\n- Bread"

Create a Google Form

Use forms_create with title "Customer Survey" and description "Help us improve our service"

Send a Chat Message

Use chat_send_message with spaceName "spaces/AAAAA" and text "Hello team!"

Schedule a Google Meet

Use meet_schedule with summary "Team Standup", startTime "2025-01-15T09:00:00-05:00", and endTime "2025-01-15T09:30:00-05:00"

Development

# Run in development mode with hot reload
pnpm dev

# Build for production
pnpm build

# Run tests
pnpm test

License

MIT License - see LICENSE for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.