Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Todo Assistant

FreeNot checked

Manages TODO tasks with operations like add, list, complete, update, and delete, stored in a JSON file.

GitHubEmbed

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

  1. Install Python 3.10+
  2. 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.

from github.com/viksnekristians/todo-mcp

Install Todo Assistant in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE
unyly install todo-assistant

Installs 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-server

FAQ

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

Compare 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