Task

You have a lightweight MCP server that manages tasks for Claude Desktop. With it, you can add tasks, list them, mark them as completed, and delete tasks, all through an MCP client interface. This server pattern keeps your task data centralized and accessible from Claude workflows.

How to use

To use this server with an MCP client, first ensure the server is running locally or reachable via a configured runtime. You will add, view, complete, and remove tasks from Claude Desktop by issuing natural language commands like “Add a task to buy groceries” or “List all my tasks.” The client translates your request into MCP actions that the server processes, keeping your task list in sync.

Configure Claude Desktop to connect to the task MCP server by adding the server entry to the MCP configuration in your Claude setup. After saving, restart Claude Desktop and verify the server connection by checking the connection indicator in the UI.

How to install

Prerequisites: you need Node/NPM tooling and the UV runtime for the recommended installation flow. Ensure you have access to a terminal or command prompt.

Option A: Run directly from a local install after cloning the project and installing dependencies.

# Clone the repository
git clone https://github.com/YOUR_USERNAME/task-mcp-server.git
cd task-mcp-server

# Install with UV-based tooling (if your project uses UV tooling)
uv pip install -e .

# Run the server
task-mcp-server

Configuration and connection

You can connect Claude Desktop to the task MCP server by adding a server entry to the MCP configuration within Claude Desktop. The entry uses a local runtime that launches the server executable. Use the command and arguments shown to start the server from your environment.

{
  "mcpServers": {
    "task-manager": {
      "command": "task-mcp-server",
      "args": []
    }
  }
}

Starting and verifying the server

Start the server using the runtime command you installed. If you run it directly, you should see the process start and await incoming MCP requests from Claude Desktop.

In Claude Desktop, restart the application after adding the server configuration. Look for the plug icon or a similar connection indicator to confirm the server is connected.

Available tools

add_task

Add a new task with a title and optional description to the task list.

list_tasks

Display all tasks with their current status (pending or completed).

complete_task

Mark a specific task as completed to update its status.

delete_task

Remove a task from the list by its identifier.