Google Tasks MCP Server
by overlay-one
A Model Context Protocol (MCP) server for Google Tasks, allowing AI assistants to interact with Google Tasks through the MCP protocol. It enables managing tasks through natural language conversations.
Last updated: N/A
What is Google Tasks MCP Server?
This is a Model Context Protocol (MCP) server that acts as a bridge between AI assistants and Google Tasks. It allows AI assistants like Claude to interact with and manage your Google Tasks using natural language commands.
How to use Google Tasks MCP Server?
First, clone the repository and install the dependencies. Then, configure your Google Cloud API access by enabling the Google Tasks API and creating OAuth 2.0 credentials. Configure the server using environment variables or a credentials file. Finally, start the server and connect it to your AI assistant, such as Claude Desktop, using the provided instructions.
Key features of Google Tasks MCP Server
List, create, update, and delete task lists
List, search, create, update, delete, and move tasks
Task organization with parent-child relationships
OAuth2 authentication with automatic token refresh
Use cases of Google Tasks MCP Server
Natural language task management with AI assistants
Project planning and task organization
Contextual understanding of due dates and task priorities
Integration with Claude Desktop for enhanced task management
FAQ from Google Tasks MCP Server
How do I authenticate with Google Tasks?
How do I authenticate with Google Tasks?
The server supports authentication via environment variables (ACCESS_TOKEN and REFRESH_TOKEN) or a credentials file (.credentials.json).
How do I integrate this server with Claude Desktop?
How do I integrate this server with Claude Desktop?
Start the Google Tasks MCP server and then launch Claude Desktop with the MCP server connection using the provided command or configuration file.
What if my access token expires?
What if my access token expires?
The server includes automatic token refresh handling. It will use the refresh token to obtain a new access token and update the credentials.
What are the required Google Cloud API credentials?
What are the required Google Cloud API credentials?
You need to enable the Google Tasks API and create OAuth 2.0 credentials, noting your Client ID and Client Secret.
How do I search for tasks?
How do I search for tasks?
Use the task.search tool with a query parameter to search for tasks by title or notes. You can optionally specify a taskListId.