Log inSubmit server
Codebeamer MCP logo

Codebeamer MCP

by 3KniGHtcZ

Connects MCP clients to Codebeamer for project, tracker, work item, traceability, review, comment, and risk management tasks.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Codebeamer MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "3knightcz-codebeamer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "codebeamer-mcp"
      ],
      "env": {
        "CB_URL": "YOUR_VALUE_HERE",
        "CB_USERNAME": "YOUR_VALUE_HERE",
        "CB_PASSWORD": "YOUR_VALUE_HERE",
        "CB_UNSAFE_SSL": "YOUR_VALUE_HERE",
        "CB_API_VERSION": "YOUR_VALUE_HERE",
        "CB_TIMEOUT_MS": "YOUR_VALUE_HERE",
        "CB_MAX_ITEMS": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y codebeamer-mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

3KniGHtcZ/codebeamer-mcp MCP server exposes Codebeamer ALM operations to MCP clients through the Codebeamer REST API v3. It supports reading projects, trackers, items, relations, references, comments, reviews, and users, along with writing items, comments, associations, references, and harms. Run it locally with Node.js and configure the Codebeamer URL, username, and password as environment variables. Reach for it when an agent needs to inspect or update Codebeamer data using natural-language requests.

Use cases

  • List Codebeamer projects and trackers
  • Search and inspect work items with full-text or cbQL queries
  • Update item status, priority, assignee, or custom fields
  • Trace dependencies and downstream references between items
  • Create risk-management harm entries with IMDRF severity

Key features

  • Project and tracker discovery
  • Full-text and cbQL item search
  • Structured item details and test steps
  • Relations, references, comments, and reviews
  • Work item creation and updates
  • RM harm creation with IMDRF codes

Tools19

What Codebeamer MCP lets your agent do. Expand a tool for its parameters.

Self-reported~328 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

96/96 checks healthy over the last 42d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · codebeamer-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars9Stargazers on the source repository.
npm downloads98Package downloads in the last 30 days.
Last commit4mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed19Callable tools this server registers over MCP.
Directory activity11 viewsConfig copies, upvotes, and views on AllMCPs.

How Codebeamer MCP works

What 3KniGHtcZ/codebeamer-mcp does

The 3KniGHtcZ/codebeamer-mcp MCP server connects an MCP client to a Codebeamer ALM instance. It provides tools for navigating projects and trackers, finding work items, reading item content and structured fields, and retrieving related lifecycle information.

Read operations cover project and tracker metadata, tracker contents, full-text or cbQL searches, item summaries, detailed item data, relations, traceability references, comments, Review Hub reviews, and user records. Detailed item results can include priority, assignees, timestamps, story points, custom fields, and test steps. The lightweight item lookup includes the description, while the detailed lookup omits it.

Write operations can create and update tracker items, add comments, connect items with associations, add downstream traceability references, and create harm entries in an RM Harms List tracker. Harm creation accepts an IMDRF code and a severity from 1 through 5.

How it works

The server runs as a local standard-input/output process and sends requests to Codebeamer’s REST API. The configured base URL identifies the Codebeamer API endpoint; the server appends the configured API version path, which defaults to v3. MCP clients invoke the exposed tools, while Codebeamer performs the underlying project, tracker, item, review, and risk-management operations.

The repository documents configuration for Claude Code, Claude Desktop, Cursor, Windsurf, VS Code Copilot, and Gemini CLI. The listed MCP configurations use npx -y codebeamer-mcp as the process command. A global npm installation or a build from source is also documented.

Setup and configuration

The 3KniGHtcZ/codebeamer-mcp server requires Node.js 20 or newer and access to a Codebeamer instance. Set these required variables before starting it:

  • CB_URL: Codebeamer API URL. The server adds /v3 by default.
  • CB_USERNAME: Codebeamer login username.
  • CB_PASSWORD: Codebeamer password.

Optional settings control connection and request behavior:

  • CB_UNSAFE_SSL: Set to true for unverified or self-signed certificates; the default is false.
  • CB_API_VERSION: API version, defaulting to v3.
  • CB_TIMEOUT_MS: Request timeout in milliseconds, defaulting to 30000.
  • CB_MAX_ITEMS: Maximum items per page, defaulting to 100.

The README warns against committing MCP configuration files containing real credentials. For development, the project includes npm build and test commands and a mock API server that does not require a real Codebeamer instance.

Tools and capabilities

The tool set is divided into read and write operations. Read tools can enumerate projects, inspect trackers, search items, retrieve item metadata, and examine relations, references, comments, reviews, and users. Write tools support item creation and updates, comments, item associations, traceability references, and RM harm records.

Item creation supports folders, item types, and parent nesting. Item updates can change names, descriptions, status, priority, assignee, and custom fields. Associations can represent links such as dependencies or blocking relationships, while references support downstream traceability between items.

Limitations and notes

The 3KniGHtcZ/codebeamer-mcp server depends on a reachable Codebeamer deployment and valid username and password credentials. Its documented API target is Codebeamer REST API v3 by default, although the API version can be changed through configuration. Operations and returned fields depend on the permissions, trackers, item types, custom fields, and Review Hub data available in the connected Codebeamer instance.

The project documentation lists Claude Code, Claude Desktop, Cursor, Windsurf, VS Code Copilot, and Gemini CLI configurations. It does not document an OAuth flow or API-key authentication; setup uses Codebeamer username and password variables instead.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Codebeamer MCP

Use Node.js 20+ and run it with `npx -y codebeamer-mcp`, then configure `CB_URL`, `CB_USERNAME`, and `CB_PASSWORD` in the MCP client.

Yes. The repository provides a Claude Desktop configuration using the `npx -y codebeamer-mcp` command and the three required Codebeamer environment variables.

It requires a Codebeamer API URL, login username, and password through `CB_URL`, `CB_USERNAME`, and `CB_PASSWORD`.

Yes. It can create items with folders, item types, and parent nesting, and update names, descriptions, status, priority, assignees, and custom fields.

Related MCP servers

All in Product Management All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewCodebeamer MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/3knightcz-codebeamer-mcp?style=directory)](https://allmcps.com/mcp/3knightcz-codebeamer-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/3knightcz-codebeamer-mcp"><img src="https://allmcps.com/api/badge/3knightcz-codebeamer-mcp?style=directory" alt="Codebeamer MCP on AllMCPs" /></a>