Agentic Backlog MCP Server

hakenshi/agentic-backlog-mcp-server

0 starsCommunity

Install to Claude Code

This server doesn't publish a one-line install command. Follow the setup in the source repository.

Summary

Enables AI agents to manage backlogs via a local API, supporting task and project operations with fail-fast resilience.

README.md

Agentic Backlog MCP Server

Local-first MCP server for AI backlog management.

This package runs over stdio (Node.js) and forwards MCP tool calls to a running backlog API.

Exposed tools

backlog.identify_project
backlog.health
backlog.version
backlog.list_projects
backlog.get_project
backlog.get_kanban_url
backlog.create_task
backlog.list_tasks
backlog.get_task
backlog.find_tasks_by_title
backlog.update_task
backlog.update_task_by_title
backlog.delete_task
backlog.update_task_status
backlog.add_task_note
backlog.plan_from_context
backlog.get_focus
backlog.claim_task
backlog.release_task
backlog.restore_task
backlog.get_board
backlog.get_console_table

Requirements

Node.js 18+

Environment

BACKLOG_API_BASE_URL=http://127.0.0.1:38117/api
BACKLOG_REQUEST_TIMEOUT_MS=1800
BACKLOG_API_FAIL_FAST_MS=15000
BACKLOG_API_FAILURE_THRESHOLD=1

Run locally

npm install
npm run build
npm start

For development:

npm run dev

MCP config example

.mcp.json file:

{
  "mcp": {
     "agentic-backlog": {
      "command": "npx",
      "args": ["-y", "@hakenshi/agentic-backlog-mcp-server"],
      "env": {
        "BACKLOG_API_BASE_URL": "http://127.0.0.1:38117/api"
      }
    }
  }
}

Notes

This server uses stdio transport only.
Do not use console.log in MCP stdio mode (stdout breaks JSON-RPC). Logs must go to stderr.
backlog.delete_task requires explicit confirm: "DELETE".
backlog.plan_from_context is preview-only by default. Set apply: true to persist changes.
API resilience is fail-fast: when repeated timeout/5xx errors happen, the server opens a short circuit window and returns immediate 503 errors so agent runs do not stall.