Skip to main content
Glama
deenesjakoruzh

FastMCP Todo Server

by MadnessEngineering
GitHub
Python
7
  • Linux
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Omnispindle

FastMCP-based task and knowledge management system for AI agents

Omnispindle is the coordination layer of the Madness Interactive ecosystem. It provides standardized MCP tools for todo management, lesson capture, and cross-project coordination that AI agents can use to actually get work done.

What it does

For AI Agents:

  • Add, query, update, and complete todos with full audit logging
  • Capture and search lessons learned across projects
  • Access project-aware context and explanations
  • Coordinate work across the Madness Interactive ecosystem

For Humans:

  • Visual dashboard through Inventorium
  • Real-time updates via MQTT
  • Claude Desktop integration via MCP
  • Project-aware working directories

For the Future:

  • Terraria mod integration (tools as inventory items - yes, really)
  • SwarmDesk 3D workspace coordination
  • Game-like AI context management for all skill levels

Quick Start

🚀 Automatic Authentication (Zero Config!)

Just add Omnispindle to your MCP client configuration:

{ "mcpServers": { "omnispindle": { "command": "python", "args": ["-m", "src.Omnispindle.stdio_server"], "cwd": "/path/to/Omnispindle", "env": { "OMNISPINDLE_TOOL_LOADOUT": "basic" } } } }

That's it! The first time you use an Omnispindle tool:

  1. 🌐 Your browser opens automatically for Auth0 login
  2. 🔐 Log in with Google (or Auth0 credentials)
  3. ✅ Token is saved locally for future use
  4. 🎯 All MCP tools work seamlessly with your authenticated context

No tokens to copy, no manual config files, no environment variables to set!

Manual Setup (Optional)

If you prefer manual configuration:

# Install dependencies pip install -r requirements.txt # Set your token (optional - automatic auth will handle this) export AUTH0_TOKEN="your_token_here" # Run the MCP server python -m src.Omnispindle.stdio_server

For more details, see the MCP Client Auth Guide.

Architecture

MCP Tools - Standard interface for AI agents to manage work MongoDB - Persistent storage with audit trails
MQTT - Real-time coordination across components FastMCP - High-performance MCP server implementation Auth0/Cloudflare - Secure authentication and access control

Tool Loadouts

Configure OMNISPINDLE_TOOL_LOADOUT to control available functionality:

  • basic - Essential todo management (7 tools)
  • minimal - Core functionality only (4 tools)
  • lessons - Knowledge management focus (7 tools)
  • full - Everything (22 tools)

Integration

Part of the Madness Interactive ecosystem:

  • Inventorium - Web dashboard and 3D workspace
  • SwarmDesk - Project-specific AI environments
  • Terraria Integration - Game-based AI interaction (coming soon)

Development

# Run tests pytest tests/ # Start STDIO MCP server (for Claude Desktop) python stdio_main.py # Start HTTP MCP server (for remote access) python -m src.Omnispindle # Check tool registration python -c "from src.Omnispindle.stdio_server import OmniSpindleStdioServer; print(len(OmniSpindleStdioServer().server._tools))"

Production Deployment

Option 1: Local STDIO (Claude Desktop)

For local development and use with clients like Claude Desktop, the stdio server is recommended. It now supports secure authentication via Auth0 tokens.

  1. Get Your Auth0 Token: Follow the instructions in the MCP Client Auth Guide.
  2. Configure Claude Desktop: Update your claude_desktop_config.json:
{ "mcpServers": { "omnispindle": { "command": "python", "args": ["-m", "src.Omnispindle.stdio_server"], "cwd": "/path/to/Omnispindle", "env": { "AUTH0_TOKEN": "your_auth0_token_here", "OMNISPINDLE_TOOL_LOADOUT": "basic" } } } }

This is now the preferred and most secure way to use Omnispindle with local MCP clients.

Option 2: Remote HTTP (Cloudflare Protected)

# Start HTTP server python -m src.Omnispindle # Deploy infrastructure cd OmniTerraformer/ ./deploy.sh

Configure MCP client:

{ "mcpServers": { "omnispindle": { "command": "mcp-remote", "args": ["https://madnessinteractive.cc/mcp/"] } } }

Privacy & Security

This repository contains sensitive configurations:

  • Auth0 client credentials and domain settings
  • Database connection strings and API endpoints
  • MCP tool implementations with business logic
  • Infrastructure as Code with account identifiers

For production use:

  • Fork this repository for your own organization
  • Update all authentication providers and credentials
  • Configure your own domain and SSL certificates
  • Review and modify tool permissions as needed

Not recommended for public deployment without modification.

Philosophy

We build tools that make AI agents actually useful for real work. Simple interfaces, robust backends, and enough ambition to make it interesting.

The todo management works today. The Terraria integration will make your kids better at prompt engineering than most adults. The 3D workspace will make remote work feel like science fiction.

But first: get your todos managed properly.

"Simple tools for complex minds, complex tools for simple minds"

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A todo management server that receives requests via FastMCP and stores them in MongoDB for processing by the Swarmonomicon todo worker.

  1. Features
    1. Installation
      1. Usage
        1. Starting the Server
        2. Adding Todos
        3. Development
      2. Integration with Swarmonomicon
        1. License
          1. Contributing

            Related Resources

            Related MCP Servers

            • Todo List MCP Server

              RegiByte
              A
              security
              A
              license
              A
              quality
              A Model Context Protocol (MCP) server that provides tools for managing todo items, including creation, updating, completion, deletion, searching, and summarizing tasks.
              Last updated -
              30
              MIT License

            • Coding Todo Server

              dennismartis
              -
              security
              F
              license
              -
              quality
              An MCP server that provides tools and resources for managing a coding project's todo list, allowing users to view, add, update, and delete todo items with details like priority, status, and tags.
              Last updated -
              1

            • FastMCP Todo Server

              MadnessEngineering
              -
              security
              F
              license
              -
              quality
              A server that receives todo requests via FastMCP and stores them in MongoDB for processing by the Swarmonomicon todo worker.
              Last updated -
              7
              • Apple

            • MCP Todo.txt Integration

              guifelix
              A
              security
              F
              license
              A
              quality
              A server implementation that enables LLMs to programmatically manage tasks in Todo.txt files using the Model Context Protocol (MCP), supporting operations like adding, completing, deleting, listing, searching, and filtering tasks.
              Last updated -
              11
              1
              8

            View all related MCP servers

            Appeared in Searches

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/MadnessEngineering/fastmcp-todo-server'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server