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, Git repositories, and more in Backlog through AI agents.

Features

• Project management (create, read, update, delete)
• Issue tracking and comments (create, update, delete, list)
• Version/Milestone management
• Wiki page support
• Git repository and pull request tools
• Notification management
• Document and document tree viewing
• GraphQL-style field selection for optimized responses
• Token limiting for large responses
• Multi-organization support
• Customizable tool name prefixing
• Dynamic toolset discovery

Available Toolsets

The server provides organized groups of tools:

• space: Manage Backlog space settings and information
• project: Manage projects, categories, custom fields, and issue types
• issue: Manage issues, comments, priorities, categories, resolutions, and watching
• wiki: Manage wiki pages
• git: Manage Git repositories and pull requests
• notifications: Manage user notifications
• document: View documents and document trees

Configuration Options

Selective Toolsets

You can enable specific toolsets using ENABLE_TOOLSETS environment variable (comma-separated list or "all"). Example: ENABLE_TOOLSETS="space,project,issue"

Response Optimization

• Enable GraphQL-style field selection with OPTIMIZE_RESPONSE=1
• Set token limits with MAX_TOKENS (default: 50000)
• Add tool name prefixes with PREFIX variable

Multi-Organization Support

Configure multiple Backlog organizations:

BACKLOG_DEFAULT_ORG=COMPANY_A
BACKLOG_ORG_COMPANY_A_DOMAIN=company-a.backlog.com
BACKLOG_ORG_COMPANY_A_API_KEY=your-api-key
BACKLOG_ORG_COMPANY_B_DOMAIN=company-b.backlog.com
BACKLOG_ORG_COMPANY_B_API_KEY=your-api-key

HTTP Transport

Supports MCP Streamable HTTP transport via MCP_TRANSPORT=http with configurable host, port, and path.

Internationalization

Override tool descriptions using .backlog-mcp-serverrc.json in your home directory or environment variables prefixed with BACKLOG_MCP_.

Usage Examples

• "List all my Backlog projects"
• "Create a new bug issue in PROJECT-KEY with high priority"
• "Show me all open pull requests in repository 'repo-name'"
• "List all items I'm watching"