https://github.com/digitalcube/advanced-backlog-mcp-server
https://github.com/digitalcube/advanced-backlog-mcp-server
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/digitalcube/advanced-backlog-mcp-server
- Owner: digitalcube
- Created: 2025-04-16T03:54:16.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-10T06:13:55.000Z (about 1 year ago)
- Last Synced: 2025-07-29T11:12:17.995Z (11 months ago)
- Language: TypeScript
- Size: 121 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - **advanced-backlog-mcp-server** - TypeScript-based `http` `git` `github` `typescript` `npm install digitalcube/advanced-backlog-mcp-server` (📦 Other)
README
# 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
```bash
# 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`
```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:
```bash
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:
```bash
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:
```bash
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