Backlog MCP Server

An MCP server implementation that integrates the Backlog API.

Tools

Project API

backlog_get_projects
- Execute projects get with pagination and filtering
backlog_get_project
- Execute project gets with project id or key

Issue API

backlog_get_issues
- Execute issues get with pagination and filtering
backlog_get_issue
- Execute issue gets with issue id or key
backlog_add_issue
- Execute issue add with issue data
backlog_update_issue
- Execute issue update with issue data
backlog_delete_issue
- Execute issue delete with issue id or key

Wiki API

backlog_get_wikis
- Execute wikis get with keyword
backlog_get_wiki
- Execute wiki gets with wiki id or key
backlog_add_wiki
- Execute wiki add with wiki data
backlog_update_wiki
- Execute wiki update with wiki data
backlog_delete_wiki
- Execute wiki delete with wiki id or key

Configuration

Getting an API Key

Sign up for a Backlog
Choose a plan (Free plan available here)
Generate your API key from the individual settings help

Environment Variables

This server requires the following environment variables:

BACKLOG_API_KEY: Your Backlog API key
BACKLOG_SPACE_ID: Your Backlog space ID

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

NPX

{
  "mcpServers": {
    "backlog": {
      "command": "npx",
      "args": [
        "-y",
        "backlog-mcp-server"
      ],
      "env": {
        "BACKLOG_API_KEY": "YOUR_API_KEY_HERE",
        "BACKLOG_SPACE_ID": "YOUR_SPACE_ID_HERE"
      }
    }
  }
}

Docker

{
  "mcpServers": {
    "backlog": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BACKLOG_API_KEY=YOUR_API_KEY_HERE",
        "-e",
        "BACKLOG_SPACE_ID=YOUR_SPACE_ID_HERE",
        "mcp/backlog"
      ],
      "env": {
        "BACKLOG_API_KEY": "YOUR_API_KEY_HERE",
        "BACKLOG_SPACE_ID": "YOUR_SPACE_ID_HERE"
      }
    }
  }
}

Development

Installation

npm install

Build

npm run build

Debug

npm run debug

Running Tests

T.B.D

Docker Build

docker build -t mcp/backlog -f Dockerfile .

Extending the Server

To add new tools:

Define a new Zod schema in src/core/schema.ts
Add a new tool definition in src/tools/toolDefinitions.ts and include it in ALL_TOOLS
Create a new handler in src/tools/handlers.ts and register it in toolHandlers
Implement business logic in a service in the src/services/ directory

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.