task-manager
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@task-managerCreate a new step named 'data validation' for execution exec-789"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Task Manager MCP
Nova Agent progress reporting MCP server.
Installation
Method 1: Docker Installation (Recommended)
1. Build Docker Image
./build-docker.sh2. Add to Claude Desktop
macOS/Windows:
claude mcp add task-manager -s user \
--env "TASK_MANAGER_HOST=host.docker.internal" \
--env "TASK_MANAGER_PORT=8080" \
--env "TASK_MANAGER_TIMEOUT=30" \
--env "USE_MOCK_CLIENT=false" \
-- docker run -i --rm \
-e TASK_MANAGER_HOST \
-e TASK_MANAGER_PORT \
-e TASK_MANAGER_TIMEOUT \
-e USE_MOCK_CLIENT \
task-manager-mcp:latestLinux:
claude mcp add task-manager -s user \
--env "TASK_MANAGER_HOST=localhost" \
--env "TASK_MANAGER_PORT=8080" \
--env "TASK_MANAGER_TIMEOUT=30" \
--env "USE_MOCK_CLIENT=false" \
-- docker run -i --rm --network=host \
-e TASK_MANAGER_HOST \
-e TASK_MANAGER_PORT \
-e TASK_MANAGER_TIMEOUT \
-e USE_MOCK_CLIENT \
task-manager-mcp:latestMock Mode (for testing):
claude mcp add task-manager-mock -s user \
--env "USE_MOCK_CLIENT=true" \
-- docker run -i --rm \
-e USE_MOCK_CLIENT \
task-manager-mcp:latestMethod 2: Local Python Installation
1. Install Dependencies
pip install -r requirements.txt2. Manual MCP Configuration
Edit Claude Desktop's MCP configuration file (refer to mcp-config-example.json):
{
"mcpServers": {
"task-manager": {
"command": "python3",
"args": ["/path/to/your/task_manager_mcp.py"],
"env": {
"TASK_MANAGER_HOST": "localhost",
"TASK_MANAGER_PORT": "8080",
"TASK_MANAGER_TIMEOUT": "30",
"USE_MOCK_CLIENT": "false"
}
}
}
}Uninstallation
# Remove MCP server
claude mcp remove task-manager
# Or remove mock version
claude mcp remove task-manager-mockRelated MCP server: Cairn
MCP Tools
Tool | Purpose |
| Update execution's session_id |
| Create a step and return step_id |
| Update step status/message |
| Health check |
Usage Example
# 1. Register session
update_execution_session(execution_id="exec-123", session_id="nova-001")
# 2. Create step
result = create_step(execution_id="exec-123", step_name="analyzing")
step_id = result["step_id"]
# 3. Complete step
update_step(execution_id="exec-123", step_id=step_id, status="completed")Step Status
running- In progresscompleted- Completedfailed- Failedskipped- Skipped
Configuration
Environment Variables
Variable | Description | Default |
| Task Manager service address |
|
| Task Manager service port |
|
| Request timeout (seconds) |
|
| Whether to use Mock client |
|
Docker Network Notes
macOS/Windows: Use
host.docker.internalto access host servicesLinux: Use
--network=hostandlocalhostto access host services
Development
Run Locally
pip install -r requirements.txt
python task_manager_mcp.pyRun Tests
make test
# or
python tests/simple_test.py
python tests/test_generated_client.pyError Handling
When backend API is unavailable, MCP returns clear error messages:
404 Error (API not implemented):
{
"success": false,
"error": "API endpoint not found: PATCH /api/executions/{id}/steps/{step_id}. The backend service may not have implemented this API yet.",
"status_code": 404,
"hint": "Please check if the Task Manager backend service has this endpoint implemented."
}Connection Failed:
{
"success": false,
"error": "Cannot connect to Task Manager service at http://localhost:8080",
"hint": "Please verify that the Task Manager service is running and the host/port are correct."
}This server cannot be deployed
Maintenance
Related MCP Connectors
MCP Server for an Agent Task Marketplace
Hosted MCP server for task-first delegation to remote workstations and workers.
MCP server for mandates, delegation, policy-gated execution, credential grants, and audit.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA reference implementation demonstrating proper MCP server patterns with HTTP transport, featuring session management, progress notifications, and example tools for testing server functionality. Serves as a clean template for building MCP servers with streamable responses and comprehensive error handling.7-
- AlicenseNot gradedqualityDmaintenanceMCP server that allows AI agents to read and update project progress across different AI coding tools and sessions, maintaining a single source of truth in a PROGRESS.md file.12 npmMIT
- FlicenseAqualityDmaintenanceMCP server for creating, monitoring, and managing Devin AI sessions.41-
- AlicenseBqualityDmaintenanceMCP server providing notifications and progress tracking for long-running operations.42 npmISC