# Google Tasks MCP Server
A Model Context Protocol (MCP) server that provides access to your Google Tasks. This server enables LLMs (like Claude) to list, create, update, complete, and delete your Google Tasks.
## Features
- **List Task Lists**: View all your task lists.
- **Manage Tasks**: Create, update, delete, and complete tasks.
- **Task Details**: Set due dates, notes, and move tasks (subtasks).
- **FastMCP**: Built using the `fastmcp` library for easy integration.
## Setup
### Prerequisites
- Python 3.10 or higher
- A Google Cloud Platform (GCP) Project
- `uv` (recommended) or `pip`
### Installation
1. Clone this repository:
```bash
git clone https://github.com/yourusername/gtasks-mcp.git
cd gtasks-mcp
```
2. Create a virtual environment and install dependencies:
```bash
# Using uv (faster)
uv venv
source .venv/bin/activate
uv pip install -r requirements.txt
# OR using pip
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
```
### Google Cloud Setup
To use this server, you need to set up a Google Cloud project and enable the Tasks API.
1. **Create a Project**: Go to the [Google Cloud Console](https://console.cloud.google.com/) and create a new project.
2. **Enable API**:
* Go to **APIs & Services** > **Library**.
* Search for "Google Tasks API" and click **Enable**.
3. **Configure Consent Screen**:
* Go to **APIs & Services** > **OAuth consent screen**.
* Select **External** (unless you are a Google Workspace user and want Internal).
* Fill in the required App Information (App name: "GTasks MCP", User support email, Developer contact email).
* Click **Save and Continue**.
* **Scopes**: Click **Add or Remove Scopes**. Filter for `tasks`. Select `https://www.googleapis.com/auth/tasks` (Access to your tasks).
* Click **Update** and then **Save and Continue**.
* **Test Users**: Add your own email address as a test user. This is critical while the app is in "Testing" mode.
4. **Create Credentials**:
* Go to **APIs & Services** > **Credentials**.
* Click **Create Credentials** > **OAuth client ID**.
* Application type: **Desktop app**.
* Name: "GTasks MCP User".
* Click **Create**.
5. **Download Client Secret**:
* Download the JSON file for your new OAuth client.
* **Rename** the file to `client_secret.json`.
* **Move** it to the root directory of this project.
### Usage with Claude for Desktop
Add the following to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"google-tasks": {
"command": "/absolute/path/to/your/venv/bin/python",
"args": [
"/absolute/path/to/gtasks-mcp/server.py"
]
}
}
}
```
*Note: Replace `/absolute/path/to/` with the actual full paths on your machine.*
## Authentication
When you first run the server (or when Claude tries to use it), it will open a browser window asking you to log in with your Google account.
1. Select the account you added as a Test User.
2. You will likely see a "Google hasn't verified this app" warning. This is expected for personal testing apps.
3. Click **Advanced** > **Go to GTasks MCP (unsafe)**.
4. Click **Continue** to grant access.
5. The browser will show "The authentication flow has completed". You can close it.
A `token.json` file will be created to store your credentials for future use.
## License
MIT
