Backlog MCP Server

A Model Context Protocol (MCP) server for interacting with the Backlog API. This server provides tools for managing projects, issues, wiki pages, and more in Backlog through AI agents like Claude Desktop / Cline /…

Local serverstdioMIT

What is the Backlog MCP Server?

Backlog MCP Server source profile. From the maintainer documentation: “A Model Context Protocol (MCP) server for interacting with the Backlog API. This server provides tools for managing projects, issues, wiki pages, and more in Backlog through AI agents like Claude Desktop / Cline / Cursor etc.”

Local setup

The project provides a local client configuration using docker. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares BACKLOG_DOMAIN, BACKLOG_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
ToolsetDescription
spaceTools for managing Backlog space settings and general information
projectTools for managing projects, categories, custom fields, and issue types
issueTools for managing issues and their comments, version milestones
wikiTools for managing wiki pages
gitTools for managing Git repositories and pull requests
notificationsTools for managing user notifications
documentTools for viewing documents and document trees
get_spaceReturns information about the Backlog space.
get_usersReturns list of users in the Backlog space.
get_myselfReturns information about the authenticated user.
get_project_listReturns list of projects.
add_projectCreates a new project.
get_projectReturns information about a specific project.
get_project_usersReturns list of users in a specific project.
update_projectUpdates an existing project.
get_issueReturns information about a specific issue.
get_issue_attachmentDownloads one attachment of an issue. Returns it as image or embedded resource content, or as base64 with format: "base64".
get_issuesReturns list of issues.
count_issuesReturns count of issues.
add_issueCreates a new issue in the specified project.
update_issueUpdates an existing issue.
delete_issueDeletes an issue.
get_issue_commentsReturns list of comments for an issue.
add_issue_commentAdds a comment to an issue.
update_issue_commentUpdates a comment on an issue.
get_related_issuesReturns list of issues related to a specific issue.
add_related_issueRelates an issue to another issue.
remove_related_issueRemoves the relation between an issue and a related issue.
get_prioritiesReturns list of priorities.
get_categoriesReturns list of categories for a project.
add_categoryCreates a new category for a project.
get_custom_fieldsReturns list of custom fields for a project.
get_issue_typesReturns list of issue types for a project.
get_resolutionsReturns list of issue resolutions.
get_watching_list_itemsReturns list of watching items for a user.
get_watching_list_countReturns count of watching items for a user.
add_watchingAdds a new watch to an issue.
update_watchingUpdates an existing watch note.
delete_watchingDeletes a watch from an issue.
mark_watching_as_readMarks a watch as read.
get_version_milestone_listReturns list of version milestones for a project.
add_version_milestoneCreates a new version milestone for a project.
update_version_milestoneUpdates an existing version milestone.
delete_version_milestoneDeletes a version milestone.
get_wiki_pagesReturns list of Wiki pages.
get_wikis_countReturns count of wiki pages in a project.
get_wikiReturns information about a specific wiki page.
add_wikiCreates a new wiki page.
get_git_repositoriesReturns list of Git repositories for a project.
get_git_repositoryReturns information about a specific Git repository.
get_pull_requestsReturns list of pull requests for a repository.
get_pull_requests_countReturns count of pull requests for a repository.
get_pull_requestReturns information about a specific pull request.
add_pull_requestCreates a new pull request.
update_pull_requestUpdates an existing pull request.
get_pull_request_commentsReturns list of comments for a pull request.
add_pull_request_commentAdds a comment to a pull request.
update_pull_request_commentUpdates a comment on a pull request.
get_notificationsReturns list of notifications.
get_notifications_countReturns count of notifications.
reset_unread_notification_countResets unread notification count.
mark_notification_as_readMarks a notification as read.
get_document_treeReturns the hierarchical tree of documents for a project, including folders and ne
get_documentsReturns a flat list of documents in a project or folder.
get_documentReturns detailed information about a specific document, including metadata, content, an

How to install the Backlog MCP Server

{
  "mcpServers": {
    "backlog": {
      "command": "docker",
      "args": [
        "run",
        "--pull",
        "always",
        "-i",
        "--rm",
        "-e",
        "BACKLOG_DOMAIN",
        "-e",
        "BACKLOG_API_KEY",
        "ghcr.io/nulab/backlog-mcp-server"
      ],
      "env": {
        "BACKLOG_DOMAIN": "your-domain.backlog.com",
        "BACKLOG_API_KEY": "YOUR_BACKLOG_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
BACKLOG_DOMAINDeclared in the maintainer’s client configuration.Check documentation
BACKLOG_API_KEYDeclared in the maintainer’s client configuration.Optional