Google MCP Server
Read/write access to Google Calendar across personal, shared, and subscribed calendars: list calendars and events (with time-range and text search), fetch individual events, create, update, and delete events, and respond to invitations (RSVP). Reads run without prompting while writes require confirmation.
Read/write access to every Google Tasks list: list task lists and tasks (with completed/deleted/hidden filters), fetch individual tasks, and create, update, complete, move between lists/positions, and delete tasks.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Overview
garretpatten/google-mcp-server is a Model Context Protocol server that lets an AI agent read and organize Google Calendar and Google Tasks. It is consumed by the opencode configuration on this machine and reuses the same OAuth app as system-scripts/backups.
Related MCP server: Calendar MCP Server
Features
Calendars — personal, shared, and subscribed calendars all surface through the Google Calendar
calendarList.List calendars and events (time ranges, text search), read single events.
Create, update, delete events; respond to invitations (RSVP).
Tasks — every task list is supported.
List task lists and tasks (completed/deleted/hidden filters), read tasks.
Create, update, complete, move, and delete tasks.
Safe by default — reads run without prompting; opencode asks before any write tool (create, update, delete, RSVP, move).
Lightweight — plain REST calls via
fetchover stdio; no heavy Google client SDK.
Quick start
Prerequisites
Node.js >= 24
Google Cloud OAuth client (client ID and secret) — the same published app used by
system-scripts/backups
Installation
Clone and install
git clone https://github.com/garretpatten/google-mcp-server cd google-mcp-server npm installConfigure OAuth — copy
.env.exampleto.envand setGOOGLE_CLIENT_IDandGOOGLE_CLIENT_SECRET.Authorize once — run the interactive consent flow; the browser opens with the full read/write Calendar and Tasks scopes and the refresh token is written back to
.env:npm run authBuild
npm run build
opencode integration
Add the server to opencode.jsonc:
"mcp": {
"google": {
"type": "local",
"command": ["node", "/home/garret/Projects/google-mcp-server/dist/index.js"],
"enabled": true
}
}Read tools are allowed without prompting; write tools are configured to ask in the opencode permission settings.
Tools
Tool | Type | Description |
| read | List accessible calendars (personal, shared, subscribed) |
| read | List events in a calendar with time range/search |
| read | Get a single event |
| write | Create an event |
| write | Update an event |
| write | Delete an event |
| write | Accept/decline an invitation (RSVP) |
| read | List task lists |
| read | List tasks in a task list |
| write | Create a task |
| write | Update a task |
| write | Mark a task completed |
| write | Move a task to another list/position |
| write | Delete a task |
Security
OAuth credentials live in the git-ignored .env. The server refreshes access tokens
automatically and never logs secrets. npm run auth writes .env with owner-only
(0600) permissions; if you create the file by hand, run chmod 600 .env. If the
refresh token is revoked, run npm run auth again.
See SECURITY.md for reporting a vulnerability.
Development
npm test
npm run typecheck
npm run lint:eslintLicense
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Calendar API for AI agents: events, availability, Google/Microsoft setup, scheduling, and iCal.
Read and change Google Calendar and Outlook events, find free time and add meeting links.
Agent-Native Google Calendar - manage events, sync, and public booking
Scheduling infrastructure for AI agents across Google and Microsoft calendars.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to view, create, update, search, and manage Google Calendar events, including multi-account support and availability checks.14 npmBusiness Source 1.1
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Google Calendar events, including reading, searching, creating, updating, and deleting events, as well as checking availability and listing calendars.213 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to interact with Google Calendar through natural language, supporting listing, creating, and searching events across accessible calendars.79 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables natural language interaction with Google Calendar through AI agent tools for scheduling, event management, and availability checking.-