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

Remote serverstreamable-httpGo

What is the 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

What you get

  • Project tools (create, read, update, delete)
  • Issue tracking and comments (create, update, delete, list)
  • Version/Milestone management (create, read, update, delete)
  • Wiki page support
  • Git repository and pull request tools
  • Notification tools

Configuration and credentials

  • Docker - A Backlog account with API access - API key from your Backlog account

Recorded tools

  • get_space — Returns information about the Backlog space.
  • get_users — Returns list of users in the Backlog space.
  • get_myself — Returns information about the authenticated user.
  • get_project_list — Returns list of projects.
  • add_project — Creates a new project.
  • get_project — Returns information about a specific project.
  • get_project_users — Returns list of users in a specific project.
  • update_project — Updates an existing project.
  • delete_project — Deletes a project.
  • get_issue — Returns information about a specific issue.
  • get_issues — Returns list of issues.
  • count_issues — Returns count of issues.
  • add_issue — Creates a new issue in the specified project.
  • update_issue — Updates an existing issue.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

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

  • Docker - A Backlog account with API access - API key from your Backlog account
VariableDescriptionRequired
BACKLOG_DOMAINDeclared in the maintainer’s client configuration.Check documentation
BACKLOG_API_KEYDeclared in the maintainer’s client configuration.Yes

Example prompts to try

  • “Use Backlog to get space.”
  • “Use Backlog to get users.”
  • “Use Backlog to get myself.”

Frequently asked questions

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 Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.