task-manager
Click on "Install 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: MCP Task
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 installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/simpleye1/task-manager-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server