Backlog MCP Server

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:

Build the server:

Development with automatic rebuild:

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

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:

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