All connection guidesConnect Claude Code

Connect Claude Code to your to-do list

If you spend the day in a terminal, your to-do list should be reachable from it. Connect Claude Code to AI TODO List and adding a task costs one sentence, "add 'fix the flaky auth test'", without breaking your flow or losing the thought by the time the build finishes.

Claude Code supports MCP natively and AI TODO List hosts an MCP server, so the setup is a single command plus a browser sign-in. Everything you add from the terminal is on the board in the browser right away.

What you need

  • An AI TODO List account. Sign in at the homepage with your email.
  • Claude Code installed (the claude command in your terminal).

Your connection address

The setup below uses this address, the AI TODO List MCP server:

Step-by-step setup

  1. Add the MCP server

    In a terminal, run the command below. It registers the AI TODO List MCP server with Claude Code under the name ai-todo-list.

    claude mcp add --transport http ai-todo-list https://api.minosin.com/api/aitodolist/v1/mcp

  2. Sign in with your email code

    A browser window opens with the AI TODO List sign-in page. Enter your email, type the code we send you, and click Allow. No API key, no config file to edit.

  3. Use it from any project

    By default the server is added for the current project. Run the same command with --scope user to have it in every project. Inside Claude Code, /mcp lists the connection and its status.

  4. Try it

    Ask Claude Code "what is on my to-do list?" or tell it to add something. It reads and changes your real board through the same tools ChatGPT and Claude use.

What you can do once connected

In the terminal the connection is mostly about capturing without switching windows, and about turning things in the code into tasks. Things people say mid-session:

  • Add a task: fix the flaky auth test.
  • Add a task for each TODO comment you just found, with the file path in the description.
  • What is due today?
  • I am done for today. Add a task that says where I left off, tagged work.
  • Tick off the CI runners task.
  • Show me everything tagged work that is still in To do.

Every change lands on the same board you see in the browser, right away. Tasks can be archived but never deleted by the assistant, so nothing is lost to a misread prompt.

Troubleshooting

claude: command not found.

Install Claude Code first (see the Claude Code documentation), then run the add command again.

The browser sign-in never opens.

Run /mcp inside Claude Code and select ai-todo-list to retry authentication. It prints the sign-in URL so you can open it yourself, which also helps over SSH.

The server is connected in one project but missing in another.

MCP servers are per project by default. Add it again with --scope user to have it everywhere.

Frequently asked questions

Does this also work with other MCP coding tools?

Yes. The command above is Claude Code's syntax, but the server address works with any MCP client. Point your tool at the same URL and sign in the same way. Cursor has its own guide with the mcp.json snippet.

Is it safe to let an AI assistant touch my to-do list?

The connection is limited on purpose: the assistant can add, edit, move, complete, reopen and archive tasks, but it can never delete one. Archived tasks keep their history and can be restored. You can disconnect the assistant at any time from its own connector settings.

Do I need a paid AI TODO List subscription?

Yes, using the board from an assistant needs an active subscription, the same one subscription that covers the web app and every connection. The yearly plan starts with a free month, so you can set the connection up and use it for a month before anything is charged.

What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI assistants talk to outside tools. AI TODO List hosts an MCP server, so any assistant that supports it can read and change your board without a plugin or an API key. You sign in once with an email code.

Do changes made by the assistant show up in the web app?

Yes, right away. The assistant works on the same board you see in the browser, so a task added from a chat is on the board before you switch tabs, and a task you drag to Done in the browser is what the assistant reads next time you ask.

Further reading

Manage your to-do list from Claude: a walkthrough with example prompts

Other assistants

Connect ChatGPT · Connect Claude · Connect Cursor

New to AI TODO List? Start free for a month, then come back and connect Claude Code in a couple of minutes.