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
- View detailed task information
- Clear completed tasks
- OAuth2 authentication with automatic token refresh
- Parallel API requests for improved performance
- TypeScript interfaces for type safety
- Comprehensive error handling
- Integration with AI assistants through MCP

pnpm install
1. Copy .env.example to .env:

2. Edit the .env file with your Google API credentials:

The server supports two authentication methods:

1. Environment Variables: Set ACCESS_TOKEN and REFRESH_TOKEN in your .env file
2. Credentials File: The server can store tokens in a .credentials.json file

The server includes automatic token refresh handling. When access tokens expire, the server will:
1. Automatically use the refresh token to obtain a new access token
2. Update the credentials in memory
3. Save the updated tokens to .credentials.json (if using file-based storage)

Here's how to set up the integration:

1. Start the Google Tasks MCP server:

   pnpm start

   

2. Launch Claude Desktop with MCP server connection:

   claude mcp --command "node /path/to/google-tasks-mcp-server/dist/index.js"

   

3. Alternative: Create a configuration file:
Create a file named claude.yaml in your home directory or project directory:

   mcp:

     command: node /path/to/google-tasks-mcp-server/dist/index.js

   

4. Inside Claude Desktop:
Once connected, Claude will have access to your Google Tasks through custom MCP resources and tools. You can ask Claude to:
- "Show me my task lists"
- "Create a new task called 'Complete project report'"
- "Find all tasks related to meetings"
- "Mark my 'Review documents' task as completed"

Claude will use the MCP server to access your Google Tasks data according to your requests.

Here are some advanced ways to use Claude with your Google Tasks:

pnpm dev

The server supports the following operations through MCP tools: