Manages Google Workspace operations across 12 services (Gmail, Drive, Calendar, Docs, Sheets, Slides, Forms, Tasks, Contacts, Chat, Apps Script, Custom Search). Supports MCP tools or CLI via uvx workspace-mcp --cli. Provides tool routing, workflows, and parameter guidance for 114 tools. Triggers for "check my email", "find a file", "schedule a meeting", "update the spreadsheet", "share a doc", "create a presentation", "add a task", "look up a contact", or any mention of Google Workspace services.
Detect which mode is available and use it.
If MCP tools from the google-workspace server are available, call them directly. The tool names in the tables below are the base names -- prefix with the server name as needed (e.g. google-workspace:search_gmail_messages).
If no MCP tools are available, execute via bash:
uvx workspace-mcp --cli <tool_name> --args '{"user_google_email": "USER_EMAIL", ...}'
Before calling a tool, read the relevant reference file for exact parameter names and types. Only use parameters documented there -- do not invent parameters.
If a tool call fails with a credential error, walk the user through this setup.
Direct the user to Google Cloud Console:
Direct the user to edit ~/.claude/settings.local.json themselves (this file is gitignored and never shared). Do not ask the user to paste secrets into the conversation. Tell them to add the following to the env block:
{
"env": {
"GOOGLE_OAUTH_CLIENT_ID": "their-client-id",
"GOOGLE_OAUTH_CLIENT_SECRET": "their-secret"
}
}
If settings.local.json already exists, they should merge into the existing env object, not replace it. These env vars are inherited by all MCP servers and CLI processes that Claude Code spawns.
start_google_auth to open the browser OAuth flow~/.google_workspace_mcp/credentials (or as configured by WORKSPACE_MCP_CREDENTIALS_DIR) for future sessionsFor server options, transport, auth modes, tool filtering, and deployment: references/server-options.md
action parameter for create/update/delete.| Task | Tool |
|---|---|
| Search/find emails | search_gmail_messages |
| Read one email | get_gmail_message_content |
| Read multiple emails | get_gmail_messages_content_batch |
| Read a thread | get_gmail_thread_content |
| Read multiple threads | get_gmail_threads_content_batch |
| Send email (new or reply) | send_gmail_message |
| Create draft | draft_gmail_message |
| Download attachment | get_gmail_attachment_content |
| Add/remove labels (one) | modify_gmail_message_labels |
| Add/remove labels (batch) | batch_modify_gmail_message_labels |
| Manage labels | manage_gmail_label |
| List labels | list_gmail_labels |
| Manage filters | manage_gmail_filter |
| List filters | list_gmail_filters |
For parameters: references/gmail.md
| Task | Tool |
|---|---|
| Search files/folders | search_drive_files |
| List items in folder | list_drive_items |
| Read file content | get_drive_file_content |
| Download file | get_drive_file_download_url |
| Create file | create_drive_file |
| Create folder | create_drive_folder |
| Copy file | copy_drive_file |
| Update file metadata | update_drive_file |
| Share / set permissions | set_drive_file_permissions |
| Manage access (add/remove) | manage_drive_access |
| Check permissions | get_drive_file_permissions |
| Get shareable link | get_drive_shareable_link |
| Check public access | check_drive_file_public_access |
| Import file to Google Doc | import_to_google_doc |
For parameters: references/drive.md
| Task | Tool |
|---|---|
| List calendars | list_calendars |
| Get events | get_events |
| Create/update/delete event | manage_event |
| Check availability | query_freebusy |
For parameters: references/calendar.md
| Task | Tool |
|---|---|
| Read doc as Markdown | get_doc_as_markdown |
| Read doc content (raw) | get_doc_content |
| Create new doc | create_doc |
| Modify text / apply styles | modify_doc_text |
| Insert elements (tables, lists, breaks) | insert_doc_elements |
| Insert image | insert_doc_image |
| Create table with data | create_table_with_data |
| Update paragraph styles | update_paragraph_style |
| Find and replace | find_and_replace_doc |
| Inspect structure | inspect_doc_structure |
| Batch update (multiple ops) | batch_update_doc |
| Headers/footers | update_doc_headers_footers |
| Manage tabs | insert_doc_tab / update_doc_tab / delete_doc_tab |
| Export to PDF | export_doc_to_pdf |
| List docs in folder | list_docs_in_folder |
| Search docs | search_docs |
| Comments | manage_document_comment / list_document_comments |
| Debug table structure | debug_table_structure |
For parameters: references/docs.md
| Task | Tool |
|---|---|
| Read cell values | read_sheet_values |
| Write/append/clear values | modify_sheet_values |
| Format cells | format_sheet_range |
| Conditional formatting | manage_conditional_formatting |
| Get spreadsheet info | get_spreadsheet_info |
| Create spreadsheet | create_spreadsheet |
| Create sheet (tab) | create_sheet |
| List spreadsheets | list_spreadsheets |
| Comments | manage_spreadsheet_comment / list_spreadsheet_comments |
For parameters: references/sheets.md
| Task | Tool |
|---|---|
| Get presentation | get_presentation |
| Get specific slide | get_page |
| Get slide thumbnail | get_page_thumbnail |
| Create presentation | create_presentation |
| Batch update | batch_update_presentation |
| Comments | manage_presentation_comment / list_presentation_comments |
For parameters: references/slides.md
| Task | Tool |
|---|---|
| Get form | get_form |
| Create form | create_form |
| Batch update form | batch_update_form |
| List responses | list_form_responses |
| Get one response | get_form_response |
| Publish settings | set_publish_settings |
For parameters: references/forms.md
| Task | Tool |
|---|---|
| List task lists | list_task_lists |
| Get task list | get_task_list |
| Manage task list (CRUD) | manage_task_list |
| List tasks | list_tasks |
| Get task | get_task |
| Manage task (CRUD/move) | manage_task |
For parameters: references/tasks.md
| Task | Tool |
|---|---|
| Search contacts | search_contacts |
| Get contact | get_contact |
| Manage contact (CRUD) | manage_contact |
| Batch manage contacts | manage_contacts_batch |
| List contact groups | list_contact_groups |
| Get contact group | get_contact_group |
| Manage contact group | manage_contact_group |
| List all contacts | list_contacts |
For parameters: references/contacts.md
| Task | Tool |
|---|---|
| List spaces | list_spaces |
| Get messages | get_messages |
| Search messages | search_messages |
| Send message | send_message |
| React to message | create_reaction |
| Download attachment | download_chat_attachment |
For parameters: references/chat.md
| Task | Tool |
|---|---|
| List projects | list_script_projects |
| Get project | get_script_project |
| Create project | create_script_project |
| Delete project | delete_script_project |
| Get file content | get_script_content |
| Update file content | update_script_content |
| Run function | run_script_function |
| Generate trigger code | generate_trigger_code |
| Manage deployments | manage_deployment / list_deployments |
| Versions | create_version / get_version / list_versions |
| Execution metrics | get_script_metrics |
| Process history | list_script_processes |
For parameters: references/apps-script.md
| Task | Tool |
|---|---|
| Web search | search_custom |
| Get search engine info | get_search_engine_info |
For parameters: references/search.md
| Task | Tool |
|---|---|
| Start OAuth flow | start_google_auth |
Parameters: user_google_email (string, optional), service_name (string, required -- e.g. "gmail", "drive"). Legacy OAuth 2.0 only -- disabled when OAuth 2.1 is enabled. In most cases, just call the tool you need and auth happens automatically.
search_gmail_messages -- find the emailget_gmail_message_content -- read it (get message_id and thread_id)send_gmail_message -- reply using in_reply_to and thread_idsearch_drive_files -- find the filemanage_drive_access -- share itget_drive_shareable_link -- get the linkget_spreadsheet_info -- get sheet namesread_sheet_values -- read current datamodify_sheet_values -- write updated dataread_sheet_values -- verify the updatecreate_doc -- create the docmodify_doc_text -- add text with formattinginsert_doc_elements -- add tables, lists, page breaksupdate_paragraph_style -- apply heading stylesget_doc_as_markdown -- verify the resultsearch_gmail_messages -- find the emailget_gmail_message_content -- get attachment metadataget_gmail_attachment_content -- download the attachmentget_doc_as_markdown -- read current contentinspect_doc_structure -- find insertion points and indicesmodify_doc_text / insert_doc_elements -- make changesget_doc_as_markdown -- verify the resultuvx workspace-mcp --cli <tool> --help for any unfamiliar tool.