Complete Google Workspace MCP server — Gmail, Calendar, Docs, Tasks, Sheets, and Contacts. Single Go binary with true multi-account support.
→ Full Installation Guide — Get running in under 10 minutes
# Build
go build -o ~/.local/bin/gsuite-mcp
# Authenticate
gsuite-mcp auth personal
# Add to your MCP client config- Multi-account: Switch accounts per-operation with
"account": "work" - Complete coverage: Gmail, Calendar, Docs, Tasks, Sheets, Contacts
- Single binary: No Python, no Node, no runtime dependencies
- MCP native: JSON Schema 2020-12, proper tool descriptions
Comparison with google-workspace MCP
| Feature | google-workspace | gsuite-mcp |
|---|---|---|
| Multi-account | User-level | Per-operation |
| JSON Schema | draft-07 (Claude errors) | 2020-12 |
| Services | Gmail only | Full Workspace |
| Runtime | Python + uv | Single Go binary |
| Batch operations | Limited | Full support |
Full inbox management: search, read, send, reply, archive, trash, labels, filters, drafts, threads, batch operations, vacation responder.
Complete calendar control: list events, create/update/delete, recurring events, free/busy queries, Google Meet integration.
Document creation and editing: create, read, append, insert, replace, delete, formatting (bold, italic, headings), lists, tables, images, headers/footers.
Task management: lists, tasks, subtasks, due dates, completion, reordering.
Spreadsheet operations: read, write, append, batch operations, create.
Contact management: list, search, create, update, delete, contact groups.
Full tool reference
| Tool | Description |
|---|---|
gmail_search |
Search messages with Gmail query syntax |
gmail_get |
Get single message with full content |
gmail_get_message |
Alias for gmail_get |
gmail_get_messages |
Batch get messages (max 25) |
gmail_get_thread |
Get full conversation thread |
gmail_send |
Send new email |
gmail_reply |
Reply to existing thread |
gmail_draft |
Create draft |
gmail_list_labels |
List all labels with counts |
| Tool | Description |
|---|---|
gmail_modify_message |
Add/remove labels |
gmail_archive |
Remove from inbox |
gmail_trash / gmail_untrash |
Move to/from trash |
gmail_mark_read / gmail_mark_unread |
Mark read status |
gmail_star / gmail_unstar |
Star/unstar |
gmail_spam / gmail_not_spam |
Spam management |
| Tool | Description |
|---|---|
gmail_batch_modify |
Batch label changes |
gmail_batch_archive |
Archive multiple |
gmail_batch_trash |
Trash multiple |
| Tool | Description |
|---|---|
gmail_get_attachment |
Download attachment |
gmail_list_filters / gmail_create_filter / gmail_delete_filter |
Filter management |
gmail_create_label / gmail_update_label / gmail_delete_label |
Label management |
gmail_list_drafts / gmail_get_draft / gmail_update_draft / gmail_delete_draft / gmail_send_draft |
Draft management |
gmail_thread_archive / gmail_thread_trash / gmail_thread_untrash / gmail_modify_thread |
Thread operations |
gmail_get_profile |
Account info |
gmail_get_vacation / gmail_set_vacation |
Vacation responder |
| Tool | Description |
|---|---|
calendar_list_events |
List events with filtering |
calendar_get_event |
Get event details |
calendar_create_event |
Create event (with optional Google Meet) |
calendar_update_event |
Update event |
calendar_delete_event |
Delete event |
calendar_list_calendars |
List available calendars |
calendar_quick_add |
Create from natural language |
calendar_free_busy |
Query availability |
calendar_list_instances |
List recurring event instances |
calendar_update_instance |
Update single recurrence |
| Tool | Description |
|---|---|
docs_create |
Create new document |
docs_get |
Get content as plain text |
docs_get_metadata |
Get title, word count |
docs_append_text |
Append to end |
docs_insert_text |
Insert at position |
docs_replace_text |
Find and replace |
docs_delete_text |
Delete range |
docs_insert_table |
Insert table |
docs_insert_link |
Insert hyperlink |
docs_format_text |
Bold, italic, color, font |
docs_clear_formatting |
Remove formatting |
docs_set_paragraph_style |
Headings, alignment |
docs_create_list / docs_remove_list |
Bullet/numbered lists |
docs_insert_page_break |
Page breaks |
docs_insert_image |
Insert image from URL |
docs_create_header / docs_create_footer |
Headers/footers |
docs_batch_update |
Raw API access |
| Tool | Description |
|---|---|
tasks_list_tasklists |
List all task lists |
tasks_list |
List tasks in a list |
tasks_get |
Get task details |
tasks_create |
Create task |
tasks_update |
Update task |
tasks_complete |
Mark complete |
tasks_delete |
Delete task |
tasks_create_tasklist / tasks_update_tasklist / tasks_delete_tasklist |
Task list management |
tasks_move |
Reorder or make subtask |
tasks_clear_completed |
Clear completed |
| Tool | Description |
|---|---|
sheets_get |
Get spreadsheet metadata |
sheets_read |
Read cell range |
sheets_write |
Write to cells |
sheets_append |
Append rows |
sheets_create |
Create spreadsheet |
sheets_batch_read |
Read multiple ranges |
sheets_batch_write |
Write multiple ranges |
sheets_clear |
Clear cell range |
| Tool | Description |
|---|---|
contacts_list |
List all contacts |
contacts_get |
Get contact details |
contacts_search |
Search contacts |
contacts_create |
Create contact |
contacts_update |
Update contact |
contacts_delete |
Delete contact |
contacts_list_groups |
List contact groups |
contacts_get_group |
Get group with members |
contacts_create_group / contacts_update_group / contacts_delete_group |
Group management |
contacts_modify_group_members |
Add/remove from group |
All tools accept an optional account parameter:
{"query": "is:unread", "account": "work"}
{"message_id": "abc123", "account": "personal"}
{"query": "from:amazon"} // uses default accountEmail triage
1. gmail_search({"query": "is:unread", "account": "support"})
2. gmail_get({"message_id": "...", "account": "support"})
3. gmail_reply({"message_id": "...", "body": "Thanks for reaching out..."})
4. gmail_batch_archive({"message_ids": [...]})
Schedule a meeting
calendar_create_event({
"summary": "Team Standup",
"start_time": "2024-02-05T09:00:00-08:00",
"end_time": "2024-02-05T09:30:00-08:00",
"attendees": ["colleague@example.com"],
"add_conferencing": true
})
Create a formatted document
1. docs_create({"title": "Project Report"})
2. docs_append_text({"document_id": "...", "text": "Project Report\n\nIntroduction..."})
3. docs_set_paragraph_style({"document_id": "...", "start_index": 1, "end_index": 15, "named_style_type": "TITLE"})
If you're an AI agent or building integrations, see docs/AGENTS.md for:
- Project architecture and patterns
- Tool registration patterns
- Error handling conventions
- Testing guidelines
These prompts work well with gsuite-mcp:
- "Show my unread emails"
- "What meetings do I have today?"
- "Send an email to X about Y"
- "Create a task to review the PR by Friday"
- "Add a new contact for John Smith"
- "What's on my work calendar this week?" (uses account parameter)
See INSTALLATION.md for full setup instructions.
Config location: ~/.config/gsuite-mcp/
~/.config/gsuite-mcp/
├── client_secret.json # Your OAuth app credentials
├── config.json # Account configuration (optional)
└── credentials/
└── {label}.json # Per-account tokens
go build -o gsuite-mcp
go test ./...
go vet ./...See docs/AGENTS.md for contribution guidelines.
See docs/ROADMAP.md for planned features and development phases.
MIT