FastMCP Todo List Server

What is FastMCP Todo List Server?

A todo list server built with FastMCP that provides tools for creating, managing, and organizing tasks. Designed to be used with Claude Desktop, it offers CRUD operations, filtering, search, backups, and statistics.

How to use FastMCP Todo List Server?

Clone the repository, create a Python virtual environment, install fastmcp and aiofiles, then run python todolist_server.py. Configure file paths via environment variables TODO_FILE and TODO_BACKUP_DIR.

Key features of FastMCP Todo List Server

• Full CRUD with rich metadata (priority, tags, due dates)
• Advanced filtering, sorting, and full-text search
• Automatic backups before every data change
• Manual on-demand backups
• Detailed statistics and input validation
• Configurable file paths and efficient caching

Use cases of FastMCP Todo List Server

• Managing personal tasks interactively through Claude Desktop
• Organizing work projects by priority, status, and tags
• Tracking deadlines and filtering overdue or upcoming items
• Maintaining a searchable task history with automated backups

FAQ from FastMCP Todo List Server

What runtime dependencies does FastMCP Todo List Server require?

Python 3, plus the fastmcp and aiofiles packages installed via pip.

Where are todos stored?

In a JSON file (default todos.json in the same directory as the script). The path can be changed via the TODO_FILE environment variable.

Are there any limits on todo fields?

Titles are limited to 100 characters, descriptions to 1000 characters. The list_todos tool returns up to 100 results by default (configurable via the limit parameter).

How can I back up my todos?

The server automatically creates a backup before every change. You can also create a manual backup at any time using the create_backup tool. Backup location is set via TODO_BACKUP_DIR.

Does the server include authentication or transport configuration?

The README does not mention authentication or transport options. The server is intended for local use with Claude Desktop.