TasksBoard logo

TasksBoard MCP server

Google Tasks MCP server for your AI agent

Connect Claude, Cursor, VS Code, Codex or any MCP client to your real Google Tasks. Your agent reads, creates and organises tasks, and every change syncs to Google Tasks, your TasksBoard board and your phone.

Connector URL

https://mcp.tasksboard.com/mcp

Free to connect · Sign in with Google · No API key, nothing to install

Setup in a minute

Connect your AI agent

Pick your client, copy the setup and sign in with Google. The server is the same everywhere: one remote URL with Google sign-in.

Claude

  1. 1

    In Claude, open Customize, then Connectors.

  2. 2

    Click “+ Add”, then “Add custom connector”.

  3. 3

    Name it TasksBoard, paste the connector URL and click Continue.

  4. 4

    Keep the detected sign-in settings, click Add and sign in with your Google account.

Connector URL
https://mcp.tasksboard.com/mcp

Works in Claude on the web, in Claude Desktop and in the mobile apps. The Free plan allows one custom connector. On Team and Enterprise plans an owner adds it under Organization settings, then members click Connect.

Let the agent do it

Prompts for connecting

Coding agents can add the server themselves. Paste one of these prompts, then sign in with Google when the browser opens.

  • Any agent

    Add the remote MCP server named tasksboard at https://mcp.tasksboard.com/mcp to your MCP configuration. It uses the Streamable HTTP transport and OAuth sign-in, so it needs no API key. When it is added, tell me how to sign in, then list my Google Tasks lists to confirm it works.

  • Claude Code

    Run this command to add the TasksBoard MCP server: claude mcp add --transport http tasksboard --scope user https://mcp.tasksboard.com/mcp Then tell me how to sign in with claude mcp login tasksboard and whether I need to restart you before the tools load.

  • Cursor

    Add this server to ~/.cursor/mcp.json and keep the servers that are already there: {"mcpServers":{"tasksboard":{"url":"https://mcp.tasksboard.com/mcp"}}} Then tell me how to enable it and sign in with Google.

  • VS Code

    Add this server to ~/.copilot/mcp-config.json and keep the servers that are already there: {"mcpServers":{"tasksboard":{"type":"http","url":"https://mcp.tasksboard.com/mcp","tools":["*"]}}} Then tell me how to start it in VS Code and sign in with Google.

  • Codex

    Run this command to add the TasksBoard MCP server: codex mcp add tasksboard --url https://mcp.tasksboard.com/mcp Then run codex mcp login tasksboard and tell me when the browser opens so I can sign in with Google.

  • Antigravity

    Add this server to ~/.gemini/config/mcp_config.json and keep the servers that are already there: {"mcpServers":{"tasksboard":{"serverUrl":"https://mcp.tasksboard.com/mcp"}}} Then tell me how to authenticate it in Antigravity with my Google account.

  • Gemini CLI

    Run this command to add the TasksBoard MCP server: gemini mcp add --transport http --scope user tasksboard https://mcp.tasksboard.com/mcp Then tell me to run /mcp auth tasksboard so I can sign in with Google.

Some agents load a new server only after a restart. The Google sign-in always happens in your browser: no agent can do that step for you.

After connecting

Prompts to try

Ask in your own words. The agent picks the right tools and works in your live Google Tasks.

  • What's still open on my default list?

  • Show all my task lists and how many open tasks each one has.

  • Add “Send the Q3 report” to my Work list, due Friday, with a note to attach the spreadsheet.

  • Read the TODO comments in this repository and create a task for each one in a new list called “Tech debt”.

  • Break “Launch the new pricing page” into five subtasks.

  • Move everything due today that I haven't finished to tomorrow.

  • Mark the invoice task as done, then clear the completed tasks from that list.

  • Move the “Book flights” task from Personal to my “Trip to Lisbon” list.

12 tools

What the server can do

Everything you would do by hand in Google Tasks, available to your agent as MCP tools.

Task lists

list_task_lists
List all your task lists.
get_task_list
Get the details of one task list.
create_task_list
Create a new task list.
update_task_list
Rename a task list.
delete_task_list
Delete a task list together with its tasks.

Tasks

list_tasks
List the tasks in a list. Open tasks by default; it can include completed ones and filter by due, completion or update date.
get_task
Get the details of one task.
create_task
Create a task with a title, notes and a due date, optionally as a subtask.
update_task
Change a task's title, notes or due date, mark it done or reopen it.
delete_task
Delete a task.
move_task
Reorder a task, nest it under a parent task or move it to another list.
clear_completed_tasks
Clear the completed tasks out of a list.

Google Tasks stores due dates without a time of day, so a task created through the server has a due date but no due time.

Real Google Tasks

Your agent works where you work

The server writes to your actual Google Tasks account, so whatever your agent does shows up everywhere you already work.

On your TasksBoard board

Your lists appear side by side as a kanban board on the web, with colours, drag and drop, and sharing for your team.

In Gmail and Google Calendar

Tasks your agent creates show up in the Google Tasks side panel of Gmail, Calendar and Docs, and dated tasks land on your calendar.

On your phone

The same tasks are in the Google Tasks app on Android and iOS, and in the TasksBoard mobile app.

Privacy

You stay in control of the connection

TasksBoard is a Google Cloud verified partner, ISO 27001 certified and GDPR compliant.

Google sign-in, no API key

You authorise the connection on Google's own screen. Your password is never shared with the AI client or with TasksBoard, and there is no key to paste into a config file.

Tasks access only

The server asks Google for your tasks and your basic profile (name and email). It has no access to your email, files or calendar events.

Disconnect any time

Remove the server from your AI client or revoke access in your Google Account settings, and the connection stops.

Frequently asked questions

Everything about connecting AI agents to Google Tasks with TasksBoard MCP.

What is the TasksBoard MCP server?

It is a remote Model Context Protocol (MCP) server for Google Tasks. AI agents such as Claude, Cursor, VS Code, Codex, Antigravity and Gemini CLI connect to it at https://mcp.tasksboard.com/mcp and can then read and manage your Google Tasks lists and tasks.

Is the Google Tasks MCP server free?

Yes. Connecting an AI agent and managing your tasks through it is free and does not need TasksBoard Premium. Premium is only about the extra features on the web board, such as list sharing, colours and backgrounds.

Do I need an API key or a local install?

No. The server is hosted, so there is nothing to run on your machine. You add one URL to your AI client and sign in with Google in the browser.

Which AI clients does it work with?

Any MCP client that supports remote servers over Streamable HTTP with OAuth. This page has setup instructions for Claude, Claude Code, Cursor, VS Code, Codex, Antigravity and Gemini CLI. For ChatGPT, use the TasksBoard app in the ChatGPT app directory.

Do I need a TasksBoard account?

You do not need a separate account. You sign in with the Google account that holds your Google Tasks, and the server works straight away. The same account opens your board on tasksboard.com whenever you want to see your lists as a kanban board.

Where are my tasks stored?

In your own Google Tasks account. The server reads and writes them through Google's official Tasks API; it does not keep a second copy of your task content.

Can the agent set a due time?

It can set the day a task is due, but not the hour. The Google Tasks API stores a due date without a time of day.

How do I disconnect an agent?

Remove the server from the MCP settings of your AI client, or revoke access in the third-party apps section of your Google Account. Your tasks stay exactly where they are.

Give your agent your task list

Add the TasksBoard MCP server once and keep your Google Tasks up to date from any AI client.