Todo Assistant
FreeNot checkedManages TODO tasks with operations like add, list, complete, update, and delete, stored in a JSON file.
About
Manages TODO tasks with operations like add, list, complete, update, and delete, stored in a JSON file.
README
A simple MCP server for managing TODO tasks. Works with any MCP-compatible client.
Setup
- Install Python 3.10+
- Install dependencies:
pip install -r requirements.txt
Connect to your MCP client
This server uses stdio transport — your MCP client starts and manages the server process automatically.
Add something like this to your client's MCP config (exact location depends on the client):
{
"mcpServers": {
"todo-assistant": {
"command": "python3",
"args": ["/full/path/to/server.py"]
}
}
}
Replace /full/path/to/server.py with the actual absolute path.
Where to put this config:
| Client | Config location |
|---|---|
| Claude Desktop | ~/.config/Claude/claude_desktop_config.json (Linux) / ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) |
| Cline (VS Code) | MCP Servers section in Cline settings, or ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json |
| Other clients | Check your client's docs for MCP server configuration |
After adding the config, restart your client so it picks up the new server.
Tools
Once connected, your AI assistant can use these tools:
| Tool | What it does |
|---|---|
add_task |
Create a task (title, description, priority) |
list_tasks |
List all/pending/completed tasks |
complete_task |
Mark a task as done |
uncomplete_task |
Mark a task as pending |
update_task |
Edit a task's title, description, or priority |
delete_task |
Remove a task |
Just ask your assistant in natural language, e.g. "add a task to buy groceries with high priority" or "show my pending tasks".
Storage
Tasks are saved to tasks.json in the server directory.
Install Todo Assistant in Claude Desktop, Claude Code & Cursor
unyly install todo-assistantInstalls into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.
First time? Get the CLI: curl -fsSL https://unyly.org/install | sh
Or configure manually
Run in your terminal:
claude mcp add todo-assistant -- uvx todo-mcp-serverFAQ
Is Todo Assistant MCP free?
Yes, Todo Assistant MCP is free — one-click install via Unyly at no cost.
Does Todo Assistant need an API key?
No, Todo Assistant runs without API keys or environment variables.
Is Todo Assistant hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Todo Assistant in Claude Desktop, Claude Code or Cursor?
Open Todo Assistant on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
Notion
Read and write pages in your workspace
by NotionLinear
Issues, cycles, triage — from Claude
by LinearGoogle Drive
Search and read your Drive files
by Googlemindsdb/mindsdb
Connect and unify data across various platforms and databases with [MindsDB as a single MCP server](https://docs.mindsdb.com/mcp/overview).
by mindsdbCompare Todo Assistant with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All productivity MCPs
