holdon-todo
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@holdon-todo show me my open todos"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
HoldOn Todo (Cursor Plugin)
Manage HoldOn Todo from Cursor via MCP: list, create, complete, and update todos.
Install (Cursor Marketplace)
Install holdon-todo from the Cursor Marketplace (or load this repo under
~/.cursor/plugins/local/holdon-todofor local testing).Open Plugins → Configure and set HoldOn PAT.
Create a token: sign in / register at todo.holdon.ltd → sidebar Extensions & tokens → Create Cursor MCP token (
todo:read/todo:write).
Related MCP server: Obsidian Tasks MCP Server
Manual MCP (mcp.json)
{
"mcpServers": {
"holdon-todo": {
"command": "node",
"args": ["/absolute/path/to/holdon-todo-mcp/dist/index.js"],
"env": {
"HOLDON_PAT": "holdon_pat_…"
}
}
}
}Optional: HOLDON_API_BASE (default https://api.holdon.ltd/api/v1).
Tools
Tool | Description |
| List groups |
| List todos ( |
| Create a todo |
| Mark done |
| Update content / status |
Develop
npm install
npm run prepare-distLocal plugin test: symlink this directory to ~/.cursor/plugins/local/holdon-todo, set HOLDON_PAT in plugin config, reload Cursor.
License
MIT. See PRIVACY.md.
Available Tools
5 toolstodo_completeA
Mark a HoldOn todo as done (status=2). Call todo_list first if uuid is unknown.
Inputs: uuid (required).
todo_createA
Create a HoldOn todo. Use when the user asks to add a reminder or task. New items are ungrouped; use todo_list to verify.
Inputs: content (required).
todo_groups_listA
List HoldOn todo groups (for matching group uuids when organizing items).
Inputs: no named parameters.
todo_listB
List HoldOn todos. status: 1=open, 2=done; omit for all.
Inputs: status.
todo_updateC
Update a HoldOn todo content or status. status: 1=open, 2=done.
Inputs: uuid (required), status, content.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Most tools target clearly distinct operations (list groups, list todos, create, update). However, todo_complete (mark done via status=2) substantially overlaps with todo_update, which can also set status=2, so an agent could reasonably reach for either when closing a task. Descriptions hint at the distinction but the boundary is not fully sharp.
All names are snake_case and share a consistent 'todo' prefix, which is highly predictable. The one deviation is todo_groups_list, which puts the resource before the verb (noun_noun_verb) while every other tool follows todo_<verb>. Minor but noticeable pattern break.
Five tools is a well-scoped surface for a todo server: listing groups, listing items, and create/update/complete cover the core interaction loop without redundancy or bloat. Each tool earns its place for the stated purpose.
The surface covers create, read, update, and completion of todos plus group listing, which handles most todo workflows. The notable gap is deletion (no todo_delete or group creation), so users cannot remove tasks or create groups; agents can partially work around this by marking items done.
Maintenance
Related MCP Connectors
Local-first task manager: create, edit, and complete tasks, projects, and checklists via MCP.
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
Headless task management for bots, apps and AI agents. Remote MCP server, OAuth or access token.
Create, list, and complete todo items through MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Todoist through the MCP interface, providing full CRUD operations for tasks and projects including creating, updating, completing, and filtering tasks with natural language commands.15 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Obsidian tasks with full CRUD operations, querying, and date-based filtering via MCP.5MIT
- AlicenseNot gradedqualityCmaintenanceEnables agents to manage personal task lists through the MCP protocol, supporting task creation, editing, completion, deletion, grouping, reordering, and JSON import/export.1AGPL 3.0
- AlicenseBqualityBmaintenanceEnables task management through MCP, including creating, reading, updating, deleting, and completing tasks, with filtering by status, priority, or due date and secure token-based authentication.6GPL 3.0