mcp-backlog-server

Backlog MCP Server

This is a TypeScript based server that integrates Backlog with the Model Context Protocol (MCP). It implements the following key concepts of MCP:

• A resource that represents a Backlog project (including URI and metadata)

• Tools for interacting with the Backlog API

• Prompts to generate summaries and analytics for Backlog data

function

resource

• Access a Backlog project via backlog://project/[id] URI

• Each project resource contains project metadata and details

• JSON-formatted resources for structured data access

• Accessing issues within a project

• Accessing a Wiki page in a project

tool

• get_backlog_user - Get current Backlog user information

• get_backlog_space - Get Backlog space information

• list_recent_projects - Lists recently viewed Backlog projects

  • Number and sort order can be set

• get_project_issues - Get the issues of a project

  • Filter by status, assignee, pagination, etc.

• get_issue_detail - Get detailed information about a specific issue

• get_issue_comments - Get the comments for an issue

• add_issue_comment - Add a comment to an issue

• get_issue_comment_count - Get the number of comments on an issue

• get_issue_comment - Get detailed information about a specific comment

• get_wiki_page_list - Get a list of Wiki pages

  • Filter by project or keyword

• get_wiki_page - Get detailed information about a specific wiki page

• update_wiki_page - Update a Wiki page

prompt

• summarize_projects - Generates summaries of recently viewed Backlog projects

• analyze_backlog_usage - Analyze Backlog usage patterns based on user, space and project data

• summarize_wiki_pages - Generate summaries of a project's Wiki pages

Related MCP server: Backlog MCP Server

Prerequisites

• A Backlog account with API access

• environmental variables:

  • BACKLOG_API_KEY : Backlog API key

  • BACKLOG_SPACE_URL : Backlog space URL (e.g. https://your-space.backlog.com )

development

Install dependencies:

npm install

Build the server:

npm run build

Development with automatic rebuild:

npm run watch

install

To use it with Claude Desktop, add your server configuration:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-backlog-server": {
      "command": "/path/to/mcp-backlog-server/build/index.js",
      "env": {
        "BACKLOG_API_KEY": "your-api-key",
        "BACKLOG_SPACE_URL": "https://your-space.backlog.com"
      }
    }
  }
}

debug

MCP servers can be difficult to debug because they communicate via standard input and output. We recommend using MCP Inspector , which is available as a package script:

npm run inspector

Inspector provides a URL to access the debugging tools in your browser.

Technical details

The server consists of the following main components:

• index.ts - Main entry point, initializes and configures the MCP server

• backlog-client.ts - A client that handles communication with the Backlog API.

• handlers/ - resource, tool and prompt handlers

  • resource-handlers.ts - Resource handlers for projects, issues, and wikis

  • tool-handlers.ts - Tools for interacting with the Backlog API

  • prompt-handlers.ts - Prompt generation functions

• types.ts - Type definitions for Backlog API responses

• config.ts - Loading configuration from environment variables