advanced-backlog-mcp-server

Backlog MCP Server

This is a Model Context Protocol (MCP) server for interacting with Backlog, a project management tool. The server provides tools to query and manage Backlog resources like projects, issues, wikis, and user activities.

Features

• Retrieve Backlog space information
• List and search projects
• Search, view, and manage issues
• Access wiki pages
• View user activities and notifications
• Get user information

Requirements

• Node.js (v14 or later)
• Backlog account with API key

Installation

# Clone the repository
git clone https://github.com/digitalcube/advanced-backlog-mcp-server.git
cd advanced-backlog-mcp-server

# Install dependencies
npm install

# Build the server
npm run build

Configuration

Claude Desktop Setup

To use the Backlog MCP server with Claude Desktop, edit the following configuration file:

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

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

Getting the Command Path

To get the correct path for the command field, run the following in the repository directory after building:

echo "\"$(pwd)/build/index.js\""

This will display the path to use in the command field.

Example: "/Users/username/development/mcp-servers/advanced-backlog-mcp-server/build/index.js"

On macOS, you can copy this directly to your clipboard with:

echo "\"$(pwd)/build/index.js\"" | pbcopy

API Key Setup

You can get your API key from your Backlog account settings.

Usage

After configuration, you can use the server with Claude Desktop or any other MCP-compatible client.

In Claude Desktop, you can use natural language queries such as:

• "Show me all my recent issues"
• "List all projects in my Backlog space"
• "Find issues assigned to me with a high priority"

Available Tools

The server provides the following tools:

• list_backlog_space - Get information about your Backlog space
• list_backlog_projects - List all projects in your Backlog space
• list_backlog_recently_viewed_issues - List recently viewed issues
• search_backlog_issues - Search for issues with various filters
• get_backlog_issue - Get details of a specific issue
• list_backlog_recently_viewed_projects - List recently viewed projects
• get_backlog_project - Get details of a specific project
• list_backlog_recently_viewed_wikis - List recently viewed wikis
• get_backlog_wiki - Get details of a specific wiki
• list_backlog_recent_user_activities - List activities of a specific user
• get_backlog_current_user - Get information about the current user
• get_backlog_user - Get information about a specific user
• list_backlog_users - List all users in your Backlog space
• list_backlog_own_notifications - List notifications for the current user

Debugging

For debugging the MCP server, you can use the MCP Inspector:

npm run inspector

This will provide a URL to access debugging tools in your browser.

Integrating with MCP Clients

This server is designed to work with any MCP-compatible client. Follow the client's documentation to connect it to this server.

License

MIT