@duytnb79/backlog-mcp

A read-only MCP server for Backlog.

Quick start:

npx -y @duytnb79/backlog-mcp

Requirements

• Node.js 20+
• A Backlog API key
• Your Backlog space URL

Installation

Run directly with npx:

npx -y @duytnb79/backlog-mcp

Or install globally:

npm install -g @duytnb79/backlog-mcp
backlog-mcp

Configuration

Create a .env file or set environment variables before starting the server:

BACKLOG_BASE_URL="https://your-space.backlog.com"
BACKLOG_API_KEY="your_backlog_api_key"
BACKLOG_TIMEOUT_MS="10000"
BACKLOG_MAX_PAGE_SIZE="100"

The server automatically loads .env when running locally.

Required:

• BACKLOG_BASE_URL
• BACKLOG_API_KEY

Optional:

• BACKLOG_TIMEOUT_MS
• BACKLOG_MAX_PAGE_SIZE

Usage

With Claude Desktop

{
  "mcpServers": {
    "backlog-mcp": {
      "command": "npx",
      "args": ["-y", "@duytnb79/backlog-mcp"],
      "env": {
        "BACKLOG_BASE_URL": "https://your-space.backlog.com",
        "BACKLOG_API_KEY": "your_backlog_api_key"
      }
    }
  }
}

With a local clone

npm install
npm run build
cp .env.example .env
node dist/index.js

Available tools

• get_notifications
• read_notification
• list_projects
• list_repositories
• list_pull_requests
• get_pull_request
• list_issues
• get_issue
• get_pull_request_comments
• get_issue_comments

Security

• Read-only access only
• No hardcoded secrets
• Requires an https Backlog base URL
• No generic passthrough endpoint tool

Notes

• Do not commit .env
• Prefer one API key per teammate
• Publishing this package does not expose Backlog data by itself; access still depends on each user's API key