Skip to content

User guide Browse guides

Connect AI tools through MCP

Let compatible AI clients read existing work and save progress within the permissions you grant.

On this page

Add a connection in a compatible client

Use a client supporting remote HTTP MCP and OAuth. Add this TodoNote server URL in its MCP settings:

https://web.todonote.app/api/mcp

Review read or write permissions

Read-only access allows viewing tasks, tags, and notes. Creating tasks or modifying records requires the corresponding write authorization.

Check the client name and permissions before allowing access. See Security & data access.

Find the task, then read its note

Ask AI to search task titles, locate the work, and read its task information and note. For example: ‘Find the release check task, read its progress, and list unresolved items.’

Task search matches titles. To understand the body, the client must read the note; a title search does not read all materials.

The release tag groups records; the selected brief note shows progress and an unchecked Windows link
Tags group the release records. The selected task note supplies the actual working context.

Review the result before saving it

Check the reasoning and next steps before asking the client to update the task or create subtasks. State actual start dates and deadlines when scheduling.

The note-writing tool replaces the whole document. Read the full current note first, preserve needed content, and submit a complete updated version.

Find ‘Product release checks’ and read its task details and current note.
Summarize completed work, open questions, and suggested next steps for my review.
After confirmation, update the original note while preserving its materials and decisions.
A new Windows download check opened on the board with instructions in its note
Turn an agreed next step into a task with enough detail to carry it out.

Use images and attachments with AI

MCP can return temporary access URLs for images and files in notes. Whether the client can display or understand them depends on that client. To save new materials, upload an asset, then insert the returned asset details into the task note.

For example: “Read the release checklist and inspect its screenshots. Attach the report I provided to this task and preserve the existing note.” Read the full note before writing, since writes replace the whole document.

Manage tags and task states

With the required write access, AI can create and update tags, attach or detach tags, change completion state, move tasks to Trash, recover them, or permanently delete them.

Be specific about the scope, such as “Add the Release checks tag to these three tasks.” Check the target tasks and scope before recovery, trashing, or permanent deletion.