add_todoLABSCO SUMMARY
The full tool set is a lot of context; the loadouts are how you keep it down.
agent_preflight registers six tools for session startup and minimal registers four — enough for an agent that only needs to add and complete tasks. get_context_bundle earns its place too: one call replaces the four or five reads an agent otherwise makes to work out where it left off.
What it is
A Python FastMCP server whose tools span task management, knowledge capture, session tracking and multi-step goals. It ships on PyPI and runs against a hosted API, a local MongoDB, or both.
What you get
- Nine todo tools: create with project, priority and metadata; query with MongoDB-style filters and change detection; patch, delete, fetch, stage for review, filter by status, fuzzy text search and list by project
- Seven lesson tools: capture with language, topic and tags, then search by text or regex, list, update and delete
- Eight session tools: create, spawn a child from a parent linked to a todo, fork, trace genealogy, render the tree, and link a todo to a session
- Five quest tools holding a multi-step objective as Quest, Chains and Todos, with a progress report naming the next actions and the blockers
- get_context_bundle returns recent todos, lessons, session state and project stats in one call; find_relevant does vector similarity across todos and lessons; preflight_rag classifies past solutions and pitfalls before you start
- A cross-agent journal — write_agent_journal and read_agent_journal — so one agent leaves notes another reads
- bring_your_own injects a Python, JavaScript or shell function as a live tool at runtime
- Ten loadouts deciding how much of the surface registers, from minimal at 4 tools up to the full set
Requirements
pip install omnispindle, then run omnispindle-stdio. MCP_USER_EMAIL is required, since data is scoped per user at the database level. The first tool call opens a browser for Auth0 login and caches the token locally. OMNISPINDLE_MODE picks the backend — api, hybrid, local or auto — with MONGODB_URI needed for the local and hybrid paths, and OMNISPINDLE_TOOL_LOADOUT controls how many tools register.
Setup effort
One command plus credentials — pip install omnispindle, then supply credentials
USE CASES
01
Picking up where the last session stopped
One call returns recent todos, lessons, session state and project stats, so the agent orients itself without a round of separate queries.
02
Handing work from one agent to the next
Spawn a child session from the parent, link it to the todo it covers, and leave a journal note the receiving agent reads.
03
Running a multi-step objective rather than a task
Create a quest instead of a todo, then read its progress report — percent complete, per-chain status, next actions and blockers.
04
Finding whether you already solved this
Semantic search across todos and lessons returns nothing when nothing clears the threshold, rather than falling back to noisy keyword matches.
40 tools
Listed in project docs. Your client may show a different list.
query_todosupdate_tododelete_todoget_todocomplete_todolist_todos_by_statussearch_todoslist_project_todosadd_lessonget_lessonupdate_lessondelete_lessonsearch_lessonsgrep_lessonslist_lessonsinventorium_sessions_listinventorium_sessions_getinventorium_sessions_createinventorium_sessions_spawninventorium_sessions_forkinventorium_sessions_genealogyinventorium_sessions_treeinventorium_todos_link_sessioncreate_questcheck_questlist_questslink_questupdate_questget_context_bundlefind_relevantpreflight_ragwrite_agent_journalread_agent_journalquery_todo_logslist_projectsexplainadd_explanationpoint_out_obviousbring_your_ownBEFORE YOU INSTALL
What to know first
Tools you get
40 tools named in the project's documentation.
Requires
- omnispindle-stdio on PATH
- MCP_USER_EMAIL in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
pip install omnispindleMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"omnispindle": {
"command": "omnispindle-stdio",
"env": {
"OMNISPINDLE_MODE": "api",
"OMNISPINDLE_TOOL_LOADOUT": "basic",
"MCP_USER_EMAIL": "<YOUR_MCP_USER_EMAIL>"
}
}
}
}
