Coding Todo MCP server

The Coding Todo Server provides a comprehensive solution for managing task lists in your coding projects. It enables you to track, update, and organize todo items with features like priority levels, status tracking, and tag categorization.

Installation

To get started with the Coding Todo Server, you'll need to install the required dependencies:

pip install -r requirements.txt

Usage

Starting the Server

Launch the server by running the main Python script:

python coding_todo.py

This will start the MCP server, making all tools and resources available to MCP clients.

Available Resources

The server provides two main resources for accessing todo information:

• Todo List Resource: todo://list - Returns all todo items with their status, title, priority, and tags
• Todo Item Resource: todo://item/{todo_id} - Returns detailed information about a specific todo item

Using the Tools

Adding a New Todo Item

Use the add_todo tool to create a new task:

Tool: add_todo
Arguments:
  - title: "Implement login feature"
  - description: "Create authentication system with password reset functionality"
  - project: "UserAuth" (optional)
  - priority: 4 (optional, 1-5 scale)
  - tags: ["authentication", "security"] (optional)

Updating Todo Status

Change the status of an existing todo item with the update_todo_status tool:

Tool: update_todo_status
Arguments:
  - id: "todo_123"
  - status: "in_progress" (options: pending/in_progress/completed)

Deleting a Todo Item

Remove a todo item using the delete_todo tool:

Tool: delete_todo
Arguments:
  - id: "todo_123"

Updating Todo Details

Modify the details of an existing todo item with the update_todo tool:

Tool: update_todo
Arguments:
  - id: "todo_123"
  - title: "Updated feature name" (optional)
  - description: "New description with more details" (optional)
  - project: "NewProject" (optional)
  - priority: 5 (optional)
  - tags: ["updated", "tags"] (optional)

Example Workflow

Here's a typical workflow for managing your coding todos:

1. Start the server using python coding_todo.py
2. Add a new todo item with the add_todo tool
3. Check your todo list using the todo://list resource
4. Update the status as you work on items with update_todo_status
5. Modify details as needed with update_todo
6. Remove completed items when no longer needed using delete_todo

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.