# Omnispindle MCP server

> Lets AI agents manage tasks, capture knowledge, track work sessions, and perform semantic searches across multi-project ecosystems.

- Repository: https://github.com/MadnessEngineering/Omnispindle
- Page: https://hostedmcp.org/servers/madnessengineering/omnispindle
- Transport: —
- Stars: 10

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `MADNESS_AUTH_TOKEN` | no | no |  |
| `MCP_USER_EMAIL` | no | no |  |
| `MONGODB_DB` | no | no |  |
| `MONGODB_URI` | no | no |  |
| `MQTT_HOST` | no | no |  |
| `MQTT_PORT` | no | no |  |
| `OMNISPINDLE_FALLBACK_ENABLED` | no | no |  |
| `OMNISPINDLE_MODE` | no | no |  |
| `OMNISPINDLE_TOOL_LOADOUT` | no | no |  |
| `OMNISPINDLE_VALIDATE_PROJECT_NAMES` | no | no |  |

## Tools (46)

- `add_todo`
- `query_todos`
- `update_todo`
- `delete_todo`
- `get_todo`
- `complete_todo`
- `list_todos_by_status`
- `search_todos`
- `list_project_todos`
- `add_lesson`
- `get_lesson`
- `update_lesson`
- `delete_lesson`
- `search_lessons`
- `grep_lessons`
- `list_lessons`
- `inventorium_sessions_list`
- `inventorium_sessions_get`
- `inventorium_sessions_create`
- `inventorium_sessions_spawn`
- `inventorium_sessions_fork`
- `inventorium_sessions_genealogy`
- `inventorium_sessions_tree`
- `inventorium_todos_link_session`
- `create_quest`
- `check_quest`
- `list_quests`
- `link_quest`
- `update_quest`
- `get_context_bundle`
- `find_relevant`
- `preflight_rag`
- `query_todo_logs`
- `list_projects`
- `point_out_obvious`
- `bring_your_own`
- `full`
- `basic`
- `minimal`
- `lessons`
- `admin`
- `write_only`
- `read_only`
- `lightweight`
- `agent_preflight`
- `refine`

## FAQ

### How do I install Omnispindle?

You can install it via PyPI using the command `pip install omnispindle`.

### How does authentication work?

It uses a zero-config device flow where the first tool call opens a browser for Auth0 login, and the token is saved locally.

### Can I limit the number of tools available to my agent?

Yes, you can control the tool loadout using the OMNISPINDLE_TOOL_LOADOUT environment variable to manage token budgets.

### What are the different operation modes?

It supports api (HTTP calls), hybrid (API-first with MongoDB fallback), local (direct MongoDB), and auto (benchmarks both).