Backlog MCP server for AI agents

The Backlog MCP Server allows MCP-compatible AI assistants to interact with Backlog project management APIs. With this server, AI clients can access and manipulate Backlog projects, issues, wikis, and more through a standardized interface.

Installation Options

Using Homebrew (macOS/Linux)

# Add the tap (only needed once)
brew tap safx/tap

# Install the MCP server
brew install mcp-backlog-server

# Install the optional Backlog CLI tool
brew install blg

To update to the latest version:

brew update
brew upgrade mcp-backlog-server

To uninstall:

brew uninstall mcp-backlog-server
brew untap safx/tap  # Optional: remove the tap

Alternative Installation Methods

Pre-built binaries: Download from the releases page
Build from source: Clone the repository and run cargo build --release

Configuration for MCP Clients

Claude Desktop

Add this to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "backlog": {
      "command": "/path/to/target/release/mcp-backlog-server",
      "args": [],
      "env": {
        "BACKLOG_BASE_URL": "https://your-space.backlog.com",
        "BACKLOG_API_KEY": "YOUR_BACKLOG_API_KEY",
        "BACKLOG_PROJECTS": "PROJ,DEMO"
      }
    }
  }
}

Cline

Add this to your Cline MCP configuration:

{
  "mcpServers": {
    "backlog_mcp_server": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "command": "/path/to/target/release/mcp-backlog-server",
      "args": [],
      "env": {
        "BACKLOG_BASE_URL": "https://your-space.backlog.com",
        "BACKLOG_API_KEY": "YOUR_BACKLOG_API_KEY",
        "BACKLOG_PROJECTS": "PROJ,DEMO"
      },
      "transportType": "stdio"
    }
  }
}

Gemini CLI

Add this to ~/.gemini/settings.json:

{
  "mcpServers": {
    "backlog_mcp_server": {
      "command": "/path/to/target/release/mcp-backlog-server",
      "timeout": 10000,
      "args": [],
      "env": {
        "BACKLOG_BASE_URL": "https://your-space.backlog.com",
        "BACKLOG_API_KEY": "YOUR_BACKLOG_API_KEY",
        "BACKLOG_PROJECTS": "PROJ,DEMO"
      }
    }
  }
}

Note: Domain name must be: backlog.com, backlog.jp, or backlogtool.com

Required Environment Variables

BACKLOG_BASE_URL: Your Backlog space URL (e.g., https://your-space.backlog.com)
BACKLOG_API_KEY: Your Backlog API key from personal settings

Optional:

BACKLOG_PROJECTS: Comma-separated list of allowed project keys (e.g., MFP,DEMO,TEST)

Available Tools

The server provides 34 tools across multiple categories:

Document Tools

document_details_get: Retrieves document details
document_attachment_download: Downloads document attachments
document_tree_get: Gets project document trees

Git Tools

git_repository_list_get: Lists Git repositories
git_repository_details_get: Gets repository details
git_pr_list_get: Lists pull requests
git_pr_details_get: Gets pull request details
git_pr_attachment_list_get: Lists PR attachments
git_pr_comment_list_get: Gets PR comments
git_pr_attachment_download: Downloads PR attachments
git_pr_comment_add: Adds comments to PRs

Issue Tools

issue_details_get: Gets issue details
issue_milestone_list_get: Lists project milestones
issue_list_by_milestone_get: Gets issues by milestone
issue_update: Updates issues
issue_comment_list_get: Gets issue comments
issue_attachment_list_get: Lists issue attachments
issue_attachment_download: Downloads issue attachments
issue_shared_file_list_get: Lists issue shared files
issue_comment_update: Updates issue comments
issue_add: Creates new issues
issue_comment_add: Adds comments to issues
issue_priority_list_get: Lists priority types

Project Tools

project_status_list_get: Lists project statuses
project_issue_type_list_get: Lists project issue types
project_custom_field_list_get: Lists project custom fields

Shared File Tools

file_shared_list_get: Lists shared files
file_shared_download: Downloads shared files

Wiki Tools

wiki_list_get: Lists wiki pages
wiki_details_get: Gets wiki page details
wiki_attachment_list_get: Lists wiki attachments
wiki_attachment_download: Downloads wiki attachments
wiki_update: Updates wiki pages

File Download Features

All download tools support format detection and handling:

Format Detection

Images: Files with image/* content type are returned as base64-encoded images
Text: Text-based files are returned as plain text
Raw bytes: Other files are returned as JSON objects with base64-encoded content

Manual Format Override

Use the optional format parameter:

"image": Force treatment as an image
"text": Force treatment as text
"raw": Force treatment as raw bytes

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "backlog" '{"command":"/path/to/target/release/mcp-backlog-server","args":[],"env":{"BACKLOG_BASE_URL":"https://your-space.backlog.com","BACKLOG_API_KEY":"YOUR_BACKLOG_API_KEY","BACKLOG_PROJECTS":"PROJ,DEMO"}}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "backlog": {
            "command": "/path/to/target/release/mcp-backlog-server",
            "args": [],
            "env": {
                "BACKLOG_BASE_URL": "https://your-space.backlog.com",
                "BACKLOG_API_KEY": "YOUR_BACKLOG_API_KEY",
                "BACKLOG_PROJECTS": "PROJ,DEMO"
            }
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "backlog": {
            "command": "/path/to/target/release/mcp-backlog-server",
            "args": [],
            "env": {
                "BACKLOG_BASE_URL": "https://your-space.backlog.com",
                "BACKLOG_API_KEY": "YOUR_BACKLOG_API_KEY",
                "BACKLOG_PROJECTS": "PROJ,DEMO"
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect

Backlog MCP server