Overview
What is Backlog MCP Server?
The Backlog MCP Server is an MCP (Model Context Protocol) server that integrates the Backlog API. It provides tools to manage projects, issues, and wikis directly from an MCP client. Intended for users who want to interact with their Backlog space through AI assistants like Claude Desktop.
How to use Backlog MCP Server?
Configure it by setting the required environment variables BACKLOG_API_KEY and BACKLOG_SPACE_ID (optionally BACKLOG_BASE_URL). Use either NPX (npx -y backlog-mcp-server) or a Docker image (mcp/backlog) in your claude_desktop_config.json. The server exposes tools for CRUD operations on projects, issues, and wikis.
Key features of Backlog MCP Server
- Full CRUD for Backlog projects, issues, and wikis
- Pagination and filtering on list endpoints
- Uses environment variables for authentication
- Supports NPX and Docker deployment
- Extensible architecture for adding new tools
- Licensed under MIT License
Use cases of Backlog MCP Server
- Manage Backlog projects and their details via natural language
- Create, update, or delete issues without leaving your chat interface
- Search and browse wiki pages in your Backlog space
- Automate routine backlog operations through AI-driven commands
FAQ from Backlog MCP Server
What is the Backlog MCP Server?
It is an MCP server that wraps the Backlog API, allowing AI assistants to perform operations on projects, issues, and wikis in a Backlog space.
What environment variables are required?
BACKLOG_API_KEY (your Backlog API key) and BACKLOG_SPACE_ID (your Backlog space ID). Optionally, BACKLOG_BASE_URL can be set if your space URL differs from the default https://{space-id}.backlog.com/api/v2.
How do I get an API key for Backlog?
Sign up for a Backlog account, choose a plan, and generate an API key from your individual settings. A free plan is available.
What tools are available?
Tools for projects (get list, get single), issues (list, get, add, update, delete), and wikis (list, get, add, update, delete). Specific command names start with backlog_ (e.g., backlog_get_issues).
What are the deployment options?
You can run the server via NPX (npx -y backlog-mcp-server) or as a Docker container (mcp/backlog). Both require the same environment variables for authentication.
