FastMCP Todo Server MCP Server

A comprehensive MCP-based todo management system, that serves as a central nervous system for Madness Interactive, a multi-project task coordination

Local serverstdioPython

What is the FastMCP Todo Server MCP Server?

A comprehensive MCP-based todo management system, that serves as a central nervous system for Madness Interactive, a multi-project task coordination workshop.

What you get

Omnispindle is the coordination spine of the Madness Interactive ecosystem — a Python FastMCP server with 38 tools that lets AI agents manage tasks, capture knowledge, coordinate sessions, track epic goals (quests), and navigate the whole workshop from a single, standardized interface. PyPI packaged. Auth0 integrated. Runs anywhere a MCP config lives.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
add_todoCreate a task with project, priority, target agent, notes, and metadata
query_todosMongoDB-style filter queries with projection, limit, offset, since change detection, and graph_root for dependency subgraph traversal
update_todoPatch any fields; metadata is deep-merged. Supports $push/$pull on array fields (e.g. metadata.blockers) for dependency linking
delete_todoRemove a task
get_todoFetch a single task by ID
complete_todoStage for review with optional comment; writes to audit log. Sets status to review, not completed
list_todos_by_statusFilter by status: pending initial in_progress blocked review completed
search_todosTokenized multi-word fuzzy text search
list_project_todosRecent tasks for a specific project
add_lessonCapture a lesson with language, topic, and tags
get_lessonFetch by ID
update_lessonPatch lesson content or metadata
delete_lessonRemove
search_lessonsText search across lesson fields

How to install the FastMCP Todo Server MCP Server

{
  "mcpServers": {
    "fastmcp-todo-server": {
      "command": "npx",
      "args": ["-y", "@madnessengineering/cartogomancy"],
      "env": {
        "OMNISPINDLE_MODE": "your-value",
        "OMNISPINDLE_TOOL_LOADOUT": "your-value",
        "MCP_USER_EMAIL": "your-value",
        "MADNESS_AUTH_TOKEN": "your-value",
        "AUTH0_TOKEN": "your-value",
        "MADNESS_API_URL": "your-value",
        "MQTT_HOST": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
OMNISPINDLE_MODEConfiguration value read at startup.Optional
OMNISPINDLE_TOOL_LOADOUTConfiguration value read at startup.Optional
MCP_USER_EMAILConfiguration value read at startup.Optional
MADNESS_AUTH_TOKENCredential the server authenticates with.Yes
AUTH0_TOKENCredential the server authenticates with.Yes
MADNESS_API_URLEndpoint or connection string the server talks to.Yes
MQTT_HOSTEndpoint or connection string the server talks to.Optional

Example prompts to try

  • “Use FastMCP Todo Server to add todo.”
  • “Use FastMCP Todo Server to query todos.”
  • “Use FastMCP Todo Server to update todo.”

Frequently asked questions

A comprehensive MCP-based todo management system, that serves as a central nervous system for Madness Interactive, a multi-project task coordination workshop. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.