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

Google Calendar

Google Gmail

Google Contacts

Google Drive

Google Docs

Google Sheets

Google Slides

Google YouTube

Google Tasks

Notes (Keep-like)

Google Forms

Google Chat

Google Meet

Examples

Send an Email

Use gmail_send with to "recipient@example.com", 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.