home / mcp / task manager mcp server

Task Manager MCP Server

Task Manager MCP Server - TypeScript implementation with standard MCP SDK

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "aafsar-task-manager-mcp-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/task-manager-mcp-server/dist/index.js"
      ],
      "env": {
        "DATA_DIR": "./data",
        "NODE_ENV": "production",
        "LOG_LEVEL": "info"
      }
    }
  }
}

This MCP server provides a production-ready Task Manager that lets AI assistants manage tasks through a standardized, type-safe interface. Built with TypeScript and runtime validation, it supports creating, listing, updating, completing, deleting, and querying tasks, with persistent storage and rich filtering for practical workflow automation.

How to use

You interact with the Task Manager MCP Server through a client that speaks the MCP interface. Use the eight available tools to manage tasks end-to-end: create tasks with optional metadata, list tasks with filters, update any field of a task, mark tasks as completed, delete tasks, search by title or description, obtain comprehensive task statistics, and clear all completed tasks. Your AI assistant can orchestrate these actions to automate workflows like sprint planning, personal task management, or project tracking.

Operates with strict type safety and runtime validation, so inputs must conform to the defined schemas. You’ll typically provide a small set of fields (such as title, priority, category, and due date) to create or update tasks, and you can refine results with status, priority, and category filters when listing tasks.

When you’re ready to start, use the standard runtime approach shown in your deployment setup. If you’re testing locally, you’ll build the project and run the server. If you’re deploying via containerization or an MCP client, you’ll connect through the appropriate command path or URL provided by your setup.

How to install

Prerequisites You need Node.js 18 or newer and npm 9 or newer to install and run the server.

Step-by-step installation and start flow 1) Clone the project 2) Install dependencies 3) Build the project 4) Run the server

Step-by-step details

Available tools

create_task

Create a new task with optional metadata including title, description, priority, category, and due date.

list_tasks

List tasks with optional filters for status, priority, and category to refine results.

update_task

Update any field of an existing task, such as title, description, priority, category, due date, or status.

complete_task

Mark a task as completed to reflect finished work.

delete_task

Remove a task permanently from storage.

search_tasks

Search tasks by title or description to quickly locate items.

get_task_stats

Retrieve statistics about tasks, including counts, completion rates, and due items.

clear_completed

Remove all completed tasks from storage to keep the dataset clean.