Knowledge Management · Developer Tools

Omnispindle logo

Omnispindle

DanEdens/Omnispindle

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.

Install

pip install omnispindle

Client configuration

{
  "mcpServers": {
    "omnispindle": {
      "command": "omnispindle-stdio",
      "env": {
        "OMNISPINDLE_MODE": "<OMNISPINDLE_MODE>",
        "OMNISPINDLE_TOOL_LOADOUT": "<OMNISPINDLE_TOOL_LOADOUT>",
        "MCP_USER_EMAIL": "<MCP_USER_EMAIL>"
      }
    }
  }
}

Environment variables

OMNISPINDLE_MODEOMNISPINDLE_TOOL_LOADOUTMCP_USER_EMAILOMNISPINDLE_VALIDATE_PROJECT_NAMESMADNESS_AUTH_TOKENMONGODB_URIMONGODB_DBMQTT_HOST
GitHub stars
3
Author
@DanEdens
Category
Knowledge Management, Developer Tools
Updated
Oct 6, 2026

About Omnispindle

Runs anywhere a MCP config lives.

A todo system that went wonderfully, intentionally wrong.

Tools (40)

  • add_todo

    Create a task with project, priority, target agent, notes, and metadata

  • query_todos

    MongoDB-style filter queries with projection, limit, offset, since change detection, and graph_root for dependency subgraph traversal

  • update_todo

    Patch any fields; metadata is deep-merged.

  • delete_todo

    Remove a task

  • get_todo

    Fetch a single task by ID

  • complete_todo

    Stage for review with optional comment; writes to audit log.

  • list_todos_by_status

    Filter by status: pending initial in_progress blocked review completed

  • search_todos

    Tokenized multi-word fuzzy text search

  • list_project_todos

    Recent tasks for a specific project

  • add_lesson

    Capture a lesson with language, topic, and tags

  • get_lesson

    Fetch by ID

  • update_lesson

    Patch lesson content or metadata

  • delete_lesson

  • search_lessons

    Text search across lesson fields

  • grep_lessons

    Regex pattern search

  • list_lessons

    Browse all lessons, with brief mode for summaries

  • inventorium_sessions_list

    List sessions, optionally filtered by project

  • inventorium_sessions_get

    Fetch a session by ID

  • inventorium_sessions_create

    Start a new AI work session

  • inventorium_sessions_spawn

    Spawn a child session from a parent, linked to a todo

  • inventorium_sessions_fork

    Fork a session with optional message inheritance

  • inventorium_sessions_genealogy

    Full ancestor/descendant trace for a session

  • inventorium_sessions_tree

    Visual session tree for a project

  • inventorium_todos_link_session

    Link a todo to a session

  • create_quest

    Create an epic goal container (Quest → Chains → Todos).

  • check_quest

    Progress report: % complete, per-chain status, next actions, blockers.

  • list_quests

    List quests filtered by status/project

  • link_quest

    Add an existing todo to a quest chain retroactively (creates chain on demand)

  • update_quest

    Update quest fields: name, description, status, success_criteria, metadata

  • get_context_bundle

    One call: recent todos, lessons, session state, project stats for an agent's working context

  • find_relevant

    Semantic similarity search across todos and lessons.

  • preflight_rag

    Pre-task lessons check: call before starting work, classifies past solutions vs pitfalls

  • write_agent_journal

    Persistent agent journal — leave notes readable by other agents for cross-agent coordination

  • query_todo_logs

    Audit log queries: filter by type, project, date range

  • list_projects

    Enumerate known projects from filesystem

  • explain

    Topic explanation system: persistent knowledge cards

  • point_out_obvious

    Logs an observation with configurable sarcasm.

  • bring_your_own

    Inject a Python, JavaScript, or shell function as a live MCP tool at runtime

  • full

    Everything

  • basic

    Core todo CRUD + context + quest system

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS

Related MCP servers

More servers
MaxKB logo

MaxKB

1Panel-dev/MaxKB

16.2k

MaxKB = Max Knowledge Brain, it is an open-source platform for building enterprise-grade agents. MaxKB integrates Retrieval-Augmented Generation (RAG) pipelines, supports robust workflows, and provides advanced MCP tool-use capabilities.

Knowledge Management
UI-TARS-desktop logo

UI-TARS-desktop

bytedance/UI-TARS-desktop

12.9k

TARS is ByteDance's multimodal AI agent stack, shipping two projects: Agent TARS (a CLI and Web UI agent built on MCP) and UI-TARS-desktop (a desktop GUI agent).

Knowledge Management
Supermemory logo

Supermemory

supermemoryai/supermemory

9.4k

State-of-the-art memory and context engine for AI.

Knowledge Management
Cognee logo

Cognee

topoteretes/cognee

2.1k

Cognee - The Free Open-Source AI Memory Platform for Agents.

Knowledge Management
Notion MCP Server (Official) logo

Notion MCP Server (Official)

makenotion/notion-mcp-server

1.5k

For the best experience, use Remote Notion MCP, our official hosted MCP server. This repository is a separate, self-hosted MCP server implementation that is no longer actively maintained or supported. Please use Remote Notion MCP instead.

Knowledge Management
DevDocs logo

DevDocs

cyberagiinc/devdocs

1.4k

[!WARNING] DevDocs Status: Not publicly maintained. Enhanced internal version at CyberAGI — public release coming soon. If you have any questions please reach out to info@cyberagi.ai.

Knowledge Management