What is Advanced Backlog Mcp Server

The advanced-backlog-mcp-server is a Model Context Protocol (MCP) server designed to interact with Backlog, a project management tool. It allows users to query and manage various Backlog resources such as projects, issues, wikis, and user activities.

Use cases

Use cases include project tracking, issue management, team collaboration, and accessing project documentation through wikis in Backlog.

How to use

To use the advanced-backlog-mcp-server, clone the repository, install the dependencies, and build the server. Configure it with your Backlog domain and API key in the specified configuration file, then run it with a compatible client like Claude Desktop.

Key features

Key features include retrieving Backlog space information, listing and searching projects, managing issues, accessing wiki pages, viewing user activities and notifications, and obtaining user information.

Where to use

The advanced-backlog-mcp-server is primarily used in project management environments where Backlog is utilized for tracking projects, issues, and team collaboration.

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