TaskManager MCP server
Enables AI clients to manage and execute tasks using a queue-based planning and execution system.
Also known as kazuph/mcp-taskmanager, @kazuph/mcp-taskmanager
- Stars
- 216
- Tools
- —
- Downloads, 30 days
- 1,928
- Latest version
- —
- Last commit
- Jun 12, 2026
- License
- MIT
What is TaskManager MCP?
TaskManager enables AI clients to manage and execute tasks using a queue-based planning and execution system.
Summary generated from the project's README
About TaskManager MCP server
Managing complex workflows through a queue-based system is what mcp-taskmanager enables for AI clients like Claude Desktop. It provides a structured way to break down large objectives into manageable steps by separating the planning phase from the execution phase. Users can submit a list of strings to create an internal queue, which the server then manages through specific actions.
Setting up this server requires Node.js 18 or higher and involves adding a configuration entry to your Claude Desktop settings file using npx. Once active, the system allows an AI to plan by storing tasks, execute by retrieving the next item in the queue, and finalize work by marking specific task IDs as complete. This approach helps maintain order during long-running processes by providing a clear overview and current queue status at each step.
What you can do with it
- 1Organize multi-step workflowsProvide a list of several objectives to create a structured execution plan.
- 2Sequential task processingRequest the next item in a queue to ensure tasks are handled one after another.
- 3Track project progressMonitor the current state of a queue and identify specific tasks by their unique identifiers.
- 4Finalize completed workRemove finished items from the active queue using their assigned task ID.
Written from the project's README. Every use case is checked against a quote from it.
How to install TaskManager MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall TaskManager MCP in Claude Code
$ claude mcp add mcp-taskmanager -- npx -y @kazuph/mcp-taskmanagerInstall TaskManager MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-taskmanager": {
"command": "npx",
"args": [
"-y",
"@kazuph/mcp-taskmanager"
]
}
}
}Install TaskManager MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-taskmanager": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@kazuph/mcp-taskmanager"
]
}
}
}Install TaskManager MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-taskmanager","type":"stdio","command":"npx","args":["-y","@kazuph/mcp-taskmanager"]}'Install TaskManager MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-taskmanager": {
"command": "npx",
"args": [
"-y",
"@kazuph/mcp-taskmanager"
]
}
}
}Install TaskManager MCP in Codex
$ codex mcp add mcp-taskmanager -- npx -y @kazuph/mcp-taskmanagerInstall TaskManager MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-taskmanager] command = "npx" args = ["-y", "@kazuph/mcp-taskmanager"]
Install TaskManager MCP in Gemini CLI
$ gemini mcp add -s user mcp-taskmanager npx -- -y @kazuph/mcp-taskmanagerInstall TaskManager MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-taskmanager": {
"command": "npx",
"args": [
"-y",
"@kazuph/mcp-taskmanager"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablekazuph/mcp-taskmanager is public and reachablegithub.com/kazuph/mcp-taskmanager ↗Pass
- Package names this repository as its source@kazuph/mcp-taskmanager names kazuph/mcp-taskmanager as sourcenpmjs.com/package/@kazuph/mcp-taskmanager ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-06-12github.com/kazuph/mcp-taskmanager ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @kazuph/mcp-taskmanagerPass
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubMCP TaskManager
Model Context Protocol server for Task Management. This allows Claude Desktop (or any MCP client) to manage and execute tasks in a queue-based system.
Quick Start (For Users)
Prerequisites
- Node.js 18+ (install via
brew install node) - Claude Desktop (install from https://claude.ai/desktop)
Configuration
- Open your Claude Desktop configuration file at:
~/Library/Application Support/Claude/claude_desktop_config.json
You can find this through the Claude Desktop menu:
-
Open Claude Desktop
-
Click Claude on the Mac menu bar
-
Click "Settings"
-
Click "Developer"
-
Add the following to your configuration:
{
"tools": {
"taskmanager": {
"command": "npx",
"args": ["-y", "@kazuph/mcp-taskmanager"]
}
}
}
For Developers
Prerequisites
- Node.js 18+ (install via
brew install node) - Claude Desktop (install from https://claude.ai/desktop)
- tsx (install via
npm install -g tsx)
Installation
git clone https://github.com/kazuph/mcp-taskmanager.git
cd mcp-taskmanager
npm install
npm run build
Development Configuration
-
Make sure Claude Desktop is installed and running.
-
Install tsx globally if you haven't:
npm install -g tsx
# or
pnpm add -g tsx
- Modify your Claude Desktop config located at:
~/Library/Application Support/Claude/claude_desktop_config.json
Add the following to your MCP client's configuration:
{
"tools": {
"taskmanager": {
"args": ["tsx", "/path/to/mcp-taskmanager/index.ts"]
}
}
}
Available Operations
The TaskManager supports two main phases of operation:
Planning Phase
- Accepts a task list (array of strings) from the user
- Stores tasks internally as a queue
- Returns an execution plan (task overview, task ID, current queue status)
Execution Phase
- Returns the next task from the queue when requested
- Provides feedback mechanism for task completion
- Removes completed tasks from the queue
- Prepares the next task for execution
Parameters
action: "plan" | "execute" | "complete"tasks: Array of task strings (required for "plan" action)taskId: Task identifier (required for "complete" action)getNext: Boolean flag to request next task (for "execute" action)
Example Usage
// Planning phase
{
action: "plan",
tasks: ["Task 1", "Task 2", "Task 3"]
}
// Execution phase
{
action: "execute",
getNext: true
}
// Complete task
{
action: "complete",
taskId: "task-123"
}
TaskManager MCP questions
How do I add TaskManager MCP to Claude Code?
Run claude mcp add mcp-taskmanager -- npx -y @kazuph/mcp-taskmanager in your terminal. Add --scope user to make it available in every project.
How do I add TaskManager MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What parameters are required for the 'plan' action?
The 'plan' action requires a tasks parameter, which is an array of task strings.
How do I use the 'complete' action?
To complete a task, you must provide the taskId associated with that specific task.