task-manager
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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
- AlicenseNot 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.7MIT
- 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.46 npmMIT
- FlicenseAqualityDmaintenanceMCP server for creating, monitoring, and managing Devin AI sessions.41-
- AlicenseBqualityDmaintenanceMCP server providing notifications and progress tracking for long-running operations.44 npmISC