Google Tasks MCP
MCP server for the Google Tasks API: task lists, subtasks, due dates, complete and move…
- Pricing
- Open source
- Runs
- Locally
- Version
- 1.1.2
- Listing updated
- 4 days ago
About Google Tasks MCP
Google Tasks MCP is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.
MCP server for the Google Tasks API: task lists, subtasks, due dates, complete and move tasks.
Install
Run in a terminal
claude mcp add mcp-google-tasks --env GOOGLE_TASKS_CLIENT_SECRET='<GOOGLE_TASKS_CLIENT_SECRET>' --env GOOGLE_TASKS_REFRESH_TOKEN='<GOOGLE_TASKS_REFRESH_TOKEN>' --env GOOGLE_TASKS_ACCESS_TOKEN='<GOOGLE_TASKS_ACCESS_TOKEN>' -- npx -y mcp-google-tasksAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-google-tasks": {
"command": "npx",
"args": [
"-y",
"mcp-google-tasks"
],
"env": {
"GOOGLE_TASKS_CLIENT_SECRET": "<GOOGLE_TASKS_CLIENT_SECRET>",
"GOOGLE_TASKS_REFRESH_TOKEN": "<GOOGLE_TASKS_REFRESH_TOKEN>",
"GOOGLE_TASKS_ACCESS_TOKEN": "<GOOGLE_TASKS_ACCESS_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-google-tasks": {
"command": "npx",
"args": [
"-y",
"mcp-google-tasks"
],
"env": {
"GOOGLE_TASKS_CLIENT_SECRET": "<GOOGLE_TASKS_CLIENT_SECRET>",
"GOOGLE_TASKS_REFRESH_TOKEN": "<GOOGLE_TASKS_REFRESH_TOKEN>",
"GOOGLE_TASKS_ACCESS_TOKEN": "<GOOGLE_TASKS_ACCESS_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-google-tasks": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-google-tasks"
],
"env": {
"GOOGLE_TASKS_CLIENT_SECRET": "<GOOGLE_TASKS_CLIENT_SECRET>",
"GOOGLE_TASKS_REFRESH_TOKEN": "<GOOGLE_TASKS_REFRESH_TOKEN>",
"GOOGLE_TASKS_ACCESS_TOKEN": "<GOOGLE_TASKS_ACCESS_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-google-tasks": {
"command": "npx",
"args": [
"-y",
"mcp-google-tasks"
],
"env": {
"GOOGLE_TASKS_CLIENT_SECRET": "<GOOGLE_TASKS_CLIENT_SECRET>",
"GOOGLE_TASKS_REFRESH_TOKEN": "<GOOGLE_TASKS_REFRESH_TOKEN>",
"GOOGLE_TASKS_ACCESS_TOKEN": "<GOOGLE_TASKS_ACCESS_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-google-tasks": {
"command": "npx",
"args": [
"-y",
"mcp-google-tasks"
],
"env": {
"GOOGLE_TASKS_CLIENT_SECRET": "<GOOGLE_TASKS_CLIENT_SECRET>",
"GOOGLE_TASKS_REFRESH_TOKEN": "<GOOGLE_TASKS_REFRESH_TOKEN>",
"GOOGLE_TASKS_ACCESS_TOKEN": "<GOOGLE_TASKS_ACCESS_TOKEN>"
}
}
}
}Configuration
GOOGLE_TASKS_CLIENT_IDGoogle OAuth2 client id (refresh-token flow).GOOGLE_TASKS_CLIENT_SECRETGoogle OAuth2 client secret (refresh-token flow). Treat it as a secret.GOOGLE_TASKS_REFRESH_TOKENGoogle OAuth2 refresh token, exchanged for access tokens automatically. Treat it as a secret.GOOGLE_TASKS_ACCESS_TOKENStatic OAuth2 access token (~1h lifetime) — alternative to the refresh-token trio, mostly for testing.GOOGLE_TASKS_OAUTH_PORTFixed port for the loopback listener of the in-chat login (127.0.0.1 + PKCE). Set it when the client runs over SSH port forwarding; otherwise a free port is picked per login.GOOGLE_TASKS_API_BASEAPI root override.GOOGLE_TASKS_TIMEOUT_MSPer-request timeout in milliseconds.GOOGLE_TASKS_MAX_RETRIESRetries on transient errors (429 always; 5xx/network for reads).
Pricing
Open source
Google Tasks MCP FAQ
Is Google Tasks MCP free?
Yes. Google Tasks MCP is open source, so you can use and self-host it for free.
How do I add Google Tasks MCP to Claude Code?
Run this command in your terminal: claude mcp add mcp-google-tasks --env GOOGLE_TASKS_CLIENT_SECRET='<GOOGLE_TASKS_CLIENT_SECRET>' --env GOOGLE_TASKS_REFRESH_TOKEN='<GOOGLE_TASKS_REFRESH_TOKEN>' --env GOOGLE_TASKS_ACCESS_TOKEN='<GOOGLE_TASKS_ACCESS_TOKEN>' -- npx -y mcp-google-tasks
What are the best alternatives to Google Tasks MCP?
The closest alternatives to Google Tasks MCP are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.
Alternatives to Google Tasks MCP

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media