delega-mcp
The delega-mcp server connects MCP-compatible clients to Delega task infrastructure, enabling natural language management of tasks, projects, and agents.
Task Management
List tasks – Retrieve tasks with filters by project, label, due date (today/upcoming/overdue), or completion status
Get task – Fetch full details of a specific task, including subtasks
Create task – Create tasks with title, description, labels, priority (1–4), due date, and project assignment
Update task – Modify any field of an existing task
Complete / Delete task – Mark tasks as completed or permanently delete them
Add comment – Attach a comment (with optional author) to a task
Delegate tasks – Create parent-child relationships for multi-agent handoffs, with chain visualization
Assign tasks – Assign or unassign tasks to specific agents
Merge context – Deep-merge persistent context data into tasks
Duplicate detection – Check for similar existing tasks before creation
Project Management
List all projects and retrieve task statistics (totals, completed today, due today, overdue, breakdowns by project)
Agent Management
List, register, and delete agents (registration returns an API key)
Additional Features
Webhook management – Create, list, and delete webhooks for event notifications (admin only)
Usage monitoring – Get quota and rate-limit information for hosted API users
Security – Secure API key handling via environment variables, key redaction in output, and HTTPS enforcement
Flexible deployment – Works with self-hosted Delega instances or the hosted api.delega.dev service
delega-mcp
MCP server for Delega — task infrastructure for AI agents.
Connect any MCP-compatible client (Claude Code, Cursor, Codex, etc.) to your Delega instance and manage tasks, projects, and agents through natural language.
Install
npm install -g @delega-dev/mcpConfigure
Add to your MCP client config (e.g. Claude Code claude_code_config.json):
{
"mcpServers": {
"delega": {
"command": "npx",
"args": ["-y", "@delega-dev/mcp"],
"env": {
"DELEGA_API_URL": "http://127.0.0.1:18890",
"DELEGA_AGENT_KEY": "dlg_your_agent_key_here"
}
}
}
}Environment Variables
Variable | Default | Description |
|
| Delega API endpoint |
| (none) | Agent API key for authenticated requests |
|
| ⚠️ Development only. Set to |
For the hosted tier, use https://api.delega.dev as the URL.
Security Notes
Non-local
DELEGA_API_URLvalues must usehttps://.Agent keys are passed through environment variables rather than command-line arguments, which avoids process-list leakage.
MCP tool output redacts full agent API keys by default.
Do not set
DELEGA_REVEAL_AGENT_KEYS=1in production. This flag exists for initial setup only. In production, a prompt-injected agent could exfiltrate keys fromcreate_agentorlist_agentstool output. Keys are returned once at creation time; userotate_agent_keyif you need a new one.
Tools
Tool | Description |
| List tasks, filter by project, label, due date, completion |
| Get full task details including subtasks |
| Create a new task |
| Update task fields (incl. |
| Assign a task to an agent (or pass |
| Delegate a task: create a child task linked to a parent (parent status flips to |
| Return the full delegation chain for a task (root + descendants, sorted by depth) |
| Merge keys into a task's persistent context blob (deep merge, not replace) |
| Check whether proposed task content is similar to existing open tasks (Jaccard similarity). Call before |
| Return quota + rate-limit info. Hosted API only ( |
| Mark a task as completed |
| Delete a task permanently |
| Add a comment to a task |
| List all projects |
| Get task statistics |
| List registered agents |
| Register a new agent (returns API key) |
| Delete an agent (refused if agent has active tasks) |
| List all webhooks (admin only) |
| Create a webhook for event notifications (admin only) |
| Delete a webhook by ID (admin only) |
Task output format
Task-returning tools (list_tasks, get_task, create_task, update_task, assign_task) render each task with assignment metadata when available:
[#42] Ship the release
Description: Cut RC, tag, push to npm
Project: Delega
Labels: release
Priority: 3
Due: 2026-04-20
Assigned to: Coordinator (#7)
Created by: planner (#3)
Completed: noAssigned to / Created by / Completed by lines are emitted only when the underlying field is populated. Self-hosted Delega returns a nested agent object so the assignee renders as <display_name> (#id); the hosted api.delega.dev tier returns the raw agent ID so it renders as #<id>.
Tasks that are part of a delegation chain also surface the chain metadata:
[#def] Draft intro
Status: delegated
Assigned to: Drafter (#3)
Created by: Coordinator (#7)
Delegation: depth 1, parent #abc, root #abc
Delegated by: Coordinator (#7)
Completed: no
Context keys: step, findings (2)Single-task tools (get_task, create_task, update_task, assign_task, delegate_task, update_task_context) use a detail render that pretty-prints the full context blob (truncated at 2000 chars). list_tasks uses the concise list render which shows Context keys: … instead.
Delegation chains
get_task_chain returns the full parent/child chain for any task in the chain. Output is indented by delegation_depth:
Delegation chain (root #abc, depth 2, 2/4 complete):
[#abc] Write report (depth 0, delegated)
[#def] Draft intro (depth 1, completed)
[#jkl] Draft conclusion (depth 1, pending)
[#ghi] Research sources (depth 2, completed)Nodes are sorted by depth then creation order (matching the API's response ordering).
Self-Hosted vs Hosted
Self-hosted (free): Run your own Delega instance, point DELEGA_API_URL at it.
Hosted: Use https://api.delega.dev — free up to 1,000 tasks/month.
Links
License
MIT
Latest Blog Posts
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/delega-dev/delega-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server