remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Uses TypeScript for implementing the Backlog integration with Model Context Protocol

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

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

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Integrates Backlog project management with Claude via Model Context Protocol, enabling access to projects, issues, and wiki pages through natural language interactions.

Related Resources

Reddit Discussion about this server