Google Tasks MCP Server

What is Google Tasks MCP Server?

A Model Context Protocol (MCP) server for Google Tasks that enables AI assistants to interact with Google Tasks through the MCP protocol. It allows listing, creating, updating, deleting, and searching tasks and task lists, with OAuth2 authentication and automatic token refresh.

How to use Google Tasks MCP Server?

Clone the repository, install dependencies with pnpm install, and build with pnpm build. Set up a Google Cloud project, enable the Tasks API, create OAuth 2.0 credentials, and configure the .env file with CLIENT_ID, CLIENT_SECRET, and REDIRECT_URI. Start the server with pnpm start, then connect Claude Desktop using claude mcp --command "node /path/to/dist/index.js" or a configuration file.

Key features of Google Tasks MCP Server

• List, create, update, and delete task lists and tasks
• Search tasks by title or notes
• Organize tasks with parent-child relationships
• OAuth2 authentication with automatic token refresh
• Parallel API requests for improved performance
• TypeScript interfaces for type safety
• Integration with AI assistants through MCP protocol

Use cases of Google Tasks MCP Server

• Manage Google Tasks through natural language conversations in Claude Desktop
• Bulk create or modify multiple tasks with a single request
• Use AI to prioritize, schedule, and summarize tasks across lists
• Automate project planning by creating task lists and tasks programmatically

FAQ from Google Tasks MCP Server

How does authentication work?

The server uses OAuth2 credentials from a Google Cloud project. It supports setting tokens directly in the .env file or storing them in a .credentials.json file, and automatically refreshes expired access tokens.

What Google Cloud API setup is required?

You must create a project in the Google Cloud Console, enable the Tasks API, and create OAuth 2.0 credentials with a Web application type and a redirect URI (e.g., http://localhost:3000/oauth2callback).

Can I use this server with Claude Desktop?

Yes, the README provides detailed setup instructions for integrating with Claude Desktop, including command-line and configuration file approaches, along with example conversations and troubleshooting tips.

What should I do if I get MCP protocol errors?

Check the server logs for specific error details. Ensure you are using compatible versions of Claude Desktop and the MCP SDK, and verify that the server is running before connecting.

What are the server’s requirements and dependencies?

It requires Node.js, pnpm, and a Google Cloud project with the Tasks API enabled. The server runs on standard input/output channels (stdio) for MCP communication.