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

Related MCP server: MCP Task Manager Server

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.