Labsco
safx logo

Backlog MCP Server

★ 14

from safx

An MCP server for interacting with the Backlog API, a project management and collaboration tool.

🔥🔥🔥✓ VerifiedFreeAdvanced setup
#automation#git

Backlog MCP Server (mcp-backlog-server)

mcp-backlog-server is a Model Context Protocol (MCP) server for interacting with the Backlog API. This server allows MCP-compatible clients (such as AI assistants) to utilize Backlog functionalities.

Available Tools

The following tools are grouped by their respective modules:

Tool Summary

With the default configuration, you have access to 36 tools for Backlog automation:

  • Documents (5 tools): View document trees, get details, download attachments, add documents, delete documents
  • Git/Pull Requests (8 tools): Manage repositories, PRs, comments, and attachments
  • Issues (12 tools): View, create, update issues, manage comments, attachments, shared files, and priorities
  • Projects (3 tools): Get project status, issue types, and custom field definitions
  • Shared Files (2 tools): Browse and download project shared files
  • Users (1 tool): List space users
  • Wikis (5 tools): Manage wiki pages, attachments, and content updates

The server includes both read operations for information gathering and write operations for taking actions.

Note: Tool names follow a category_resource_action pattern (e.g., issue_details_get, wiki_update) to enable category-based filtering with --allowedTools (e.g., claude --allowedTools "mcp__backlog__issue_*").

Document Tools

  • document_details_get: Retrieves details for a specific Backlog document
  • document_attachment_download: Download a document attachment
  • document_tree_get: Get the document tree for a specified project
  • document_add: Add a new document to a Backlog project
  • document_delete: Delete a document from Backlog

Git Tools

  • git_repository_list_get: Get a list of Git repositories for a specified project
  • git_repository_details_get: Get details for a specific Git repository
  • git_pr_list_get: Get a list of pull requests for a specified repository
  • git_pr_details_get: Get details for a specific pull request
  • git_pr_attachment_list_get: Get a list of attachments for a specific pull request
  • git_pr_comment_list_get: Get a list of comments for a specific pull request
  • git_pr_attachment_download: Download a pull request attachment
  • git_pr_comment_add: Add a comment to a specific pull request

Issue Tools

  • issue_details_get: Retrieves details for a specific Backlog issue
  • issue_milestone_list_get: Retrieves a list of versions (milestones) for a specified project
  • issue_list_by_milestone_get: Retrieves a list of issues associated with a specified milestone
  • issue_update: Updates a Backlog issue including summary, description, and custom fields
  • issue_comment_list_get: Gets comments for a specific issue
  • issue_attachment_list_get: Get a list of attachments for a specified issue
  • issue_attachment_download: Download an issue attachment
  • issue_shared_file_list_get: Get a list of shared files linked to a specified issue
  • issue_comment_update: Update an existing comment on a Backlog issue
  • issue_add: Create a new issue in a Backlog project with support for custom fields
  • issue_comment_add: Add a comment to a specific issue
  • issue_priority_list_get: Get a list of priority types available in the space

Project Tools

  • project_status_list_get: Get a list of statuses for a specified project
  • project_issue_type_list_get: Get a list of issue types for a specified project
  • project_custom_field_list_get: Get a list of custom fields defined for a specified project

Shared File Tools

  • file_shared_list_get: Get a list of shared files for a specified project directory
  • file_shared_download: Download a shared file

User Tools

  • user_list_get: Get a list of users in the space

Wiki Tools

  • wiki_list_get: Get a list of wiki pages
  • wiki_details_get: Get detailed information about a specific wiki page
  • wiki_attachment_list_get: Get a list of attachments for a specified wiki page
  • wiki_attachment_download: Download an attachment from a wiki page
  • wiki_update: Update a wiki page

File Download Features

All file download tools (document_attachment_download, issue_attachment_download, git_pr_attachment_download, wiki_attachment_download, and file_shared_download) support format detection and handling:

Format Detection

  • Images: Files with image/* content type are detected and returned as base64-encoded images via rmcp::model::Content::image
  • Text: Files with text-based content types (text/*, application/json, application/xml, etc.) or files that contain valid UTF-8 text are returned as plain text via rmcp::model::Content::text
  • Raw bytes: All other files are returned as JSON objects with base64-encoded content, filename, and MIME type

Manual Format Override

You can explicitly specify the format using the optional format parameter:

  • "image": Force treatment as an image (validates content type)
  • "text": Force treatment as text (validates UTF-8 encoding)
  • "raw": Force treatment as raw bytes (no validation)

Content Type Detection

The system uses multiple strategies to determine if a file is text:

  • Content-Type header analysis
  • UTF-8 validity checking
  • Character composition analysis (graphic, whitespace, and valid UTF-8 characters)

How to Build

# Default build (includes all writable features)
cargo build --package mcp-backlog-server

Feature Flags

The MCP server supports multiple feature flags to enable different write operations:

  • issue_writable (enabled by default)

    • Enables: issue_update, issue_comment_update, issue_add, and issue_comment_add tools
    • Allows AI agents to create issues, modify issue content, and manage comments

  • git_writable (enabled by default)

    • Enables: git_pr_comment_add tool
    • Allows AI agents to add comments to pull requests

  • wiki_writable (enabled by default)

    • Enables: wiki_update tool
    • Allows AI agents to update wiki page content, names, and notification settings

  • document_writable (enabled by default)

    • Enables: document_add and document_delete tools
    • Allows AI agents to create and delete documents

Build Configuration

# Read-only mode (no write operations)
cargo build --package mcp-backlog-server --no-default-features

# Selective features
cargo build --package mcp-backlog-server --features issue_writable
cargo build --package mcp-backlog-server --features "issue_writable,git_writable"
cargo build --package mcp-backlog-server --features "issue_writable,git_writable,wiki_writable,document_writable"