Power your agent
การติดตั้งจากผู้เผยแพร่ ไม่ใช่เอนด์พอยต์ของ PlugMCP
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
A Model Context Protocol (MCP) server that integrates with Google APIs (Calendar, Drive, Gmail, Sheets, Docs) to provide seamless access to Google services through MCP-compatible clients.
MCP server for Google Workspace APIs - Calendar, Drive, Gmail, Sheets, Docs, and Slides integration
# Install via Homebrew
brew tap ngs/tap
brew install google-mcp-server
# Configure Claude Desktop (Apple Silicon)
echo '{
"mcpServers": {
"google": {
"command": "/opt/homebrew/bin/google-mcp-server"
}
}
}' > ~/Library/Application\ Support/Claude/claude_desktop_config.json
# Run to authenticate (first time only)
google-mcp-server
For detailed setup instructions, see below.
brew tap ngs/tap
brew install google-mcp-server
git clone https://github.com/ngs/google-mcp-server.git
cd google-mcp-server
go build
go install go.ngs.io/google-mcp-server@latest
Download pre-built binaries from the releases page for:
Create a Google Cloud Project
Create OAuth 2.0 Credentials
Configure the Server
Create a config.json file:
{
"oauth": {
"client_id": "YOUR_CLIENT_ID.apps.googleusercontent.com",
"client_secret": "YOUR_CLIENT_SECRET",
"redirect_uri": "http://localhost:8080/callback"
},
"services": {
"calendar": {"enabled": true},
"drive": {"enabled": true},
"gmail": {"enabled": true},
"sheets": {"enabled": true},
"docs": {"enabled": true},
"slides": {"enabled": true}
}
}
Or use environment variables:
export GOOGLE_CLIENT_ID="YOUR_CLIENT_ID.apps.googleusercontent.com"
export GOOGLE_CLIENT_SECRET="YOUR_CLIENT_SECRET"
Run the Server
./google-mcp-server
On first run, it will open a browser for authentication. Grant the requested permissions to proceed.
accounts_list - List all authenticated Google accountsaccounts_details - Get detailed information about accountsaccounts_add - Add a new Google accountaccounts_remove - Remove an authenticated accountaccounts_refresh - Refresh authentication token for an accountcalendar_list - List all accessible calendarscalendar_events_list - List events with date range filtering (supports account parameter)calendar_events_list_all_accounts - List events from all authenticated accountscalendar_event_create - Create new events (supports account parameter)calendar_event_update - Update existing eventscalendar_event_delete - Delete eventscalendar_event_get - Get event detailscalendar_freebusy_query - Query free/busy informationcalendar_event_search - Search for eventsdrive_files_list - List files and folders (supports account parameter)drive_files_list_all_accounts - List files from all authenticated accountsdrive_files_search - Search for files (supports account parameter)drive_file_download - Download files (supports account parameter)drive_file_upload - Upload files (supports account parameter)drive_markdown_upload - Upload Markdown content as formatted Google Docs (RECOMMENDED for Markdown)drive_markdown_replace - Replace Google Doc content with formatted Markdowndrive_file_get_metadata - Get file metadata (supports account parameter)drive_file_update_metadata - Update file metadata (supports account parameter)drive_folder_create - Create folders (supports account parameter)drive_file_move - Move files (supports account parameter)drive_file_copy - Copy files (supports account parameter)drive_file_delete - Delete files (supports account parameter)drive_file_trash - Move files to trash (supports account parameter)drive_file_restore - Restore files from trash (supports account parameter)drive_shared_link_create - Create shareable links (supports account parameter)drive_permissions_list - List file permissions (supports account parameter)drive_permissions_create - Grant permissions (supports account parameter)drive_permissions_delete - Remove permissions (supports account parameter)drive_comments_list - List comments and replies on a file, including Google Docs (supports account parameter)drive_comment_create - Add a comment to a file (supports account parameter)drive_comment_reply_create - Reply to a comment, optionally resolving or reopening it (supports account parameter)drive_comment_resolve - Resolve a comment, optionally with a closing reply (supports account parameter)Comments on Google Docs, Sheets and Slides are Drive comments, so these tools work for those files too. They use the existing drive scope, so no re-authentication is needed. Comments created through the API cannot be attached to a text range in Google Workspace editors: they appear as file-level comments, and quoted_text is shown only as the quoted context.
gmail_messages_list - List email messages (supports account parameter)gmail_messages_list_all_accounts - List messages from all authenticated accountsgmail_message_get - Get email details (supports account parameter)sheets_spreadsheet_create - Create a new spreadsheetsheets_spreadsheet_get - Get spreadsheet metadatasheets_values_get - Get cell valuessheets_values_update - Update cell valuessheets_values_append - Append rows after the last row of data in a rangesheets_values_clear - Clear the values in a range (destructive)sheets_sheet_duplicate - Duplicate a sheet (tab) within a spreadsheetsheets_sheet_add - Add a new sheet (tab) to a spreadsheetsheets_sheet_delete - Delete a sheet (tab) from a spreadsheet (destructive)sheets_sheet_update - Update sheet properties (title, position, visibility)sheets_dimension_insert - Insert rows or columns into a sheetsheets_dimension_delete - Delete rows or columns from a sheet (destructive)sheets_cells_format - Apply cell formatting (background color, text style, alignment, number format) without touching valuessheets_cells_get_format - Read the formatting a range carries, without reading its valuesAll Sheets tools support the account parameter.
docs_document_get - Get document contentdocs_document_create - Create new documentsdocs_document_update - Update document content (append or replace)slides_presentation_create - Create new presentation (supports account parameter)slides_presentation_get - Get presentation metadata (supports account parameter)slides_presentations_list_all_accounts - List presentations from all authenticated accountsslides_slide_create - Create new slide (supports account parameter)slides_slide_delete - Delete slide (supports account parameter)slides_slide_duplicate - Duplicate slide (supports account parameter)slides_markdown_create - Create presentation from Markdown with auto-pagination (supports account parameter)slides_markdown_update - Update presentation with Markdown content (supports account parameter)slides_markdown_append - Append slides from Markdown (supports account parameter)slides_add_text - Add text box to slide (supports account parameter)slides_add_image - Add image to slide (supports account parameter)slides_add_table - Add table to slide (supports account parameter)slides_add_shape - Add shape to slide (supports account parameter)slides_set_layout - Set slide layout (supports account parameter)slides_export_pdf - Export presentation as PDF (supports account parameter)slides_share - Create shareable link (supports account parameter)slides_layouts_list - List masters, layouts and their placeholders (supports account parameter)slides_slide_create_from_layout - Create a slide from a layout and fill its placeholders (supports account parameter)slides_replace_all_text - Replace text tokens across the deck (supports account parameter)slides_slide_reorder - Move slides to a new position (supports account parameter)Build a deck from a designer-made template by writing into the layouts it already defines, instead of placing new text boxes. The template keeps ownership of the design, so the result cannot drift out of alignment.
See what the template offers:
slides_layouts_list with the presentation IDtype and index pairs such as TITLE[0] and BODY[0]Create a slide from a layout:
slides_slide_create_from_layout with the layout name and the
placeholders to fill:{
"presentation_id": "1AbC...",
"layout_name": "Title and body",
"placeholders": [
{ "type": "TITLE", "text": "Quarterly review" },
{ "type": "BODY", "text": "Revenue up\nChurn down\nTwo hires", "bullets": true }
]
}
No shape is created and nothing existing is moved or restyled. Text is inserted as written, so Markdown markers are not interpreted.
The server supports managing multiple Google accounts simultaneously with automatic context-aware selection:
List authenticated accounts:
accounts_list to see all authenticated accountsAdd additional accounts:
accounts_add to get an authorization URLAutomatic account selection:
account parameter in any toolCross-account operations:
*_list_all_accounts tools to search across all authenticated accountscalendar_events_list_all_accounts), Gmail (gmail_messages_list_all_accounts), and Drive (drive_files_list_all_accounts)If you installed via Homebrew, add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"google": {
"command": "/opt/homebrew/bin/google-mcp-server"
}
}
}
For Intel Macs, use /usr/local/bin/google-mcp-server instead.
Add to your Claude Desktop configuration:
{
"mcpServers": {
"google": {
"command": "/path/to/google-mcp-server"
}
}
}
Claude Code users can set up the Google MCP Server using either the claude mcp add command or manual configuration:
Install the server (if not already installed):
# Using Homebrew (recommended for macOS)
brew tap ngs/tap
brew install google-mcp-server
# Or build from source
git clone https://github.com/ngs/google-mcp-server.git
cd google-mcp-server
go build
Add the MCP server to Claude Code:
# If installed via Homebrew (Apple Silicon)
claude mcp add google /opt/homebrew/bin/google-mcp-server
# If installed via Homebrew (Intel Mac)
claude mcp add google /usr/local/bin/google-mcp-server
# If built from source
claude mcp add google /path/to/your/google-mcp-server/google-mcp-server
Configure OAuth credentials:
config.json file with your OAuth credentials in the current directory or home directoryexport GOOGLE_CLIENT_ID="YOUR_CLIENT_ID.apps.googleusercontent.com"
export GOOGLE_CLIENT_SECRET="YOUR_CLIENT_SECRET"
Authenticate (first time only):
# Run the server directly to complete OAuth flow
google-mcp-server
# This will open a browser for authentication
# Grant the requested permissions
# The token will be saved to ~/.google-mcp-accounts/<email>.json
Restart Claude Code to apply the changes:
# The MCP server will be available after restarting Claude Code
Install the server (same as Method 1, step 1)
Configure OAuth credentials (same as Method 1, step 3)
Authenticate (same as Method 1, step 4)
Manually configure Claude Code:
Add the MCP server to your Claude Code configuration. Create or edit ~/.claude/config.json:
{
"mcpServers": {
"google": {
"command": "/opt/homebrew/bin/google-mcp-server"
}
}
}
Or if you built from source:
{
"mcpServers": {
"google": {
"command": "/path/to/your/google-mcp-server/google-mcp-server"
}
}
}
In Claude Code, you can test the connection by asking:
claude mcp list to verify the server is registeredclaude mcp remove google then add it againchmod +x /path/to/google-mcp-server~/.google-mcp-accounts/ after authenticationgoogle-mcp-server --version to ensure it works~/.google-mcp-accounts/ directory for token filesThe Google Slides integration includes powerful Markdown-to-Slides conversion with automatic pagination:
## Main Title
### Subtitle
(This creates a title slide with TITLE layout)
---
# Title Slide
Subtitle text
---
## Section Title
- Bullet point 1
- Bullet point 2
- Nested bullet
---
### Content Slide
Regular paragraph text
**Bold text** and *italic text*
1. Numbered list
2. Second item
---
## Image Slide
Images are rendered at 50% of slide size and centered
---
| Column 1 | Column 2 |
|----------|----------|
| Data 1 | Data 2 |
---
```code
// Code block
function example() {
return true;
}
Features:
- **Auto-pagination**: Content automatically flows to new slides when exceeding page limits
- **Force page breaks**: Use `---` to explicitly create new slides
- **Configurable font size**: Default 14pt with automatic line height calculation
- **Smart layout**: Titles, bullets, tables, images, and code blocks are properly formatted
- **Image support**:
- Images rendered at 50% of slide size, centered
- Alt text displayed as caption below the image
- Automatic TITLE_ONLY layout for slides with images
- **Title slide detection**: Slides with only two headings automatically use the TITLE layout for better visual presentation
- **Layout optimization**:
- TITLE layout: Used for slides with only headings (perfect for title/section slides)
- TITLE_AND_BODY layout: Used for regular content slides
- TITLE_ONLY layout: Used for slides containing tables or images (provides more space)
### Programmatic Usage
```python
# Example: List upcoming calendar events
response = mcp_client.call_tool(
"calendar_events_list",
{
"calendar_id": "primary",
"time_min": "2024-01-01T00:00:00Z",
"max_results": 10
}
)
# Example: Create presentation from Markdown
response = mcp_client.call_tool(
"slides_markdown_create",
{
"title": "My Presentation",
"markdown": markdown_content,
"account": "[email protected]"
}
)
The server looks for configuration in the following locations (in order):
config.json in the current directoryconfig.local.json in the current directory~/.google-mcp-server/config.json/etc/google-mcp-server/config.jsonGOOGLE_CLIENT_ID - OAuth client IDGOOGLE_CLIENT_SECRET - OAuth client secretGOOGLE_REDIRECT_URI - OAuth redirect URIGOOGLE_TOKEN_FILE - Token storage locationDISABLE_<SERVICE> - Disable specific services (e.g., DISABLE_GMAIL=true)LOG_LEVEL - Logging level (debug, info, warn, error)This server supports both personal Google accounts (@gmail.com) and Google Workspace accounts. For Workspace accounts:
See WORKSPACE_SETUP.md for detailed instructions on configuring the server for Google Workspace environments.
~/.google-mcp-accounts/ directory with restricted permissionsAuthentication Errors (403: access_denied)
If you encounter a 403 access_denied error during OAuth authentication, see the detailed OAuth Setup Guide for step-by-step instructions.
Quick checklist:
Configuration File Issues
~/.google-mcp-server/config.jsonPermission Denied
Rate Limiting
Token Expiration
accounts_remove then accounts_addrm ~/.google-mcp-accounts/<email>.json# Clone the repository
git clone https://github.com/ngs/google-mcp-server.git
cd google-mcp-server
# Install dependencies
go mod download
# Build
go build
# Run tests
go test ./...
# Run with race detector
go test -race ./...
git checkout -b feature/amazing-feature)git commit -m 'Add amazing feature')git push origin feature/amazing-feature)See CONTRIBUTING.md for detailed guidelines.
Each Google API has its own rate limits:
The server implements automatic retry with exponential backoff when limits are reached.
This project is licensed under the MIT License - see the LICENSE file for details.
For issues, questions, or contributions, please visit the GitHub repository.
MCP server for Google Workspace APIs - Calendar, Drive, Gmail, Sheets, Docs, and Slides integration
เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Google ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-10-28 MCP server for Google Workspace APIs - Calendar, Drive, Gmail, Sheets, Docs, and Slides integration
