Google MCP

by pegasusheavy

Not rated
GitHub

About

A all-in-one Google Workspace MCP server

Details

Author
pegasusheavy
Categories
Productivity

Setup

Install Google MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/pegasusheavy/google-mcp

Follow the installation instructions in the repository README, then restart your MCP client.

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.

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

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

- 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

- 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

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

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

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

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

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

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

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

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

# Clone the repository cd google-mcp # Install dependencies pnpm install # Build the project pnpm build

Before using this server, you need to set up Google Cloud credentials:
- Go toGoogle Cloud Console
- Create a new project or select an existing one
- 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
- Navigate toAPIs & Services > Credentials
- ClickCreate Credentials > OAuth client ID
- SelectDesktop appas the application type
- Download the JSON file

Save the downloaded JSON file ascredentials.jsonat the appropriate location for your platform:

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

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

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

{ "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"] } }
{ "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"] } } }

On first use, call thegoogle_authtool to initiate OAuth authentication:

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

Use gmail_send with to "recipient@example.com", subject "Hello", and body "This is a test email."
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"
Use youtube_search with query "MCP tutorial" and type "video"
Use docs_create with title "Meeting Notes" and content "# Weekly Meeting\n\nAttendees: ..."
Use sheets_read with spreadsheetId "abc123" and range "Sheet1!A1:D10"
Use drive_search with query "quarterly report"
Use notes_create with title "Shopping List" and content "- Milk\n- Eggs\n- Bread"
Use forms_create with title "Customer Survey" and description "Help us improve our service"
Use chat_send_message with spaceName "spaces/AAAAA" and text "Hello team!"
Use meet_schedule with summary "Team Standup", startTime "2025-01-15T09:00:00-05:00", and endTime "2025-01-15T09:30:00-05:00"
# Run in development mode with hot reload pnpm dev # Build for production pnpm build # Run tests pnpm test

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

The 1Password MCP server creates a bridge that allows MCP clients such as Codex and Kiro to manage your 1Password Environments with secure authorization prompts.

This is the 1st, easiest, and cheapest PPT, slides, presentation AI generation MCP Server in the world.

Persistent memory for any AI assistant. Zero token cost until recall. Stores memories in local SQLite, ranks by 6-factor scoring, returns results 79% smaller than JSON. Works with Claude, ChatGPT, Grok, Cursor, Windsurf, and any MCP client.

A MCP server that enables AI assistants to interact with Anki, the spaced repetition flashcard application.

Enables LLM clients to interact with macOS applications through AppleScript. Built using the @beyondbetter/bb-mcp-server library, this server provides safe, controlled execution of predefined scripts with optional support for arbitrary script execution.

An MCP server for WordPress plugin audits

Turn your AI assistant into a digital marketing hub that creates, organizes, and analyzes links and QR Codes on demand.

Connect AI clients to Cal.com scheduling through the Model Context Protocol using the hosted server at mcp.cal.com or a local instance.

Sync Calendars, Scheduling Links, AI Executive Scheduling Assistant, Unified Calendar

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.