What can you do with this server?

The codebeamer-mcp server provides an MCP interface for natural language interaction with Codebeamer ALM, enabling you to manage projects, trackers, and work items via Claude and other MCP clients (Claude Desktop, Cursor, Windsurf, VS Code Copilot, Gemini CLI). Read Operations * List/retrieve projects, trackers, and work items (with pagination) * Get tracker details including field schema, statuses, and priorities * Search items via full-text or structured cbQL queries (filter by status, priority, assignee, date, etc.) * Get item details: custom fields, status, priority, assignees * Get item relations (associations), traceability references (upstream/downstream), and comments * Look up user profiles Write Operations * Create items – with support for folders, item types, parent nesting, assignees, status, priority, story points, and descriptions * Update items – modify name, description, status, priority, assignees, and story points * Add comments – in plain text or wiki markup * Create associations – link items with typed relations (e.g., depends on, blocks, related to) * Create traceability references – add downstream references between items * Create harm entries – specialized creation in RM Harms List trackers with IMDRF codes and severity ratings (1–5)

Which integrations are available for this server?

Supports integration with Codeium's Windsurf editor through MCP configuration, allowing developers to access Codebeamer ALM data directly within their development environment for requirements management and traceability.

de en es ja ko ru zh

codebeamer-mcp

by 3KniGHtcZ

Overview Schema Related Servers Score Discussions

TypeScript

Remote

codebeamer-mcp

An MCP (Model Context Protocol) server for Codebeamer ALM. Allows Claude and other MCP clients to read and write projects, trackers, and items in Codebeamer using natural language.

codebeamer-mcp MCP server

Tools (19)

Read

Tool	Description
`list_projects`	List all projects
`get_project`	Get project details
`list_trackers`	List trackers in a project
`get_tracker`	Get tracker details
`list_tracker_items`	List items in a tracker
`search_items`	Full-text / cbQL search
`get_item`	Get item summary: ID, name, tracker, status and description. Lightweight — use when you only need to identify the item and read its content
`get_item_details`	Get full structured detail of an item: project, priority, assignees, timestamps, story points, custom fields and test steps. Description omitted — fetch it via `get_item`
`get_item_relations`	Get outgoing/incoming associations (depends on, blocks, …)
`get_item_references`	Get upstream/downstream traceability references (derived from, covers, …)
`get_item_comments`	Get item comments
`get_item_reviews`	Get Review Hub reviews for an item (result, reviewers, votes)
`get_user`	Get user details

Write

Tool	Description
`create_item`	Create a new item in a tracker. Supports folders, item type, and parent nesting
`update_item`	Update an existing item (name, description, status, priority, assignee, custom fields)
`add_comment`	Add a comment to an item
`create_association`	Create an association between two items (e.g. depends on, blocks)
`create_reference`	Add a downstream traceability reference between two items
`create_harm`	Create a harm entry in an RM Harms List tracker with IMDRF code and severity (1–5)

Related MCP server: Redmine MCP Server

Installation

Requirements

Node.js 20+
Access to a Codebeamer instance (URL, username, password)

Claude Code (CLI)

The fastest way — run this command in your terminal:

claude mcp add codebeamer -e CB_URL=https://your-instance.example.com/cb/api \
  -e CB_USERNAME=your_username -e CB_PASSWORD=your_password \
  -- npx -y codebeamer-mcp

Or add it manually to .mcp.json in the project root (or ~/.claude/mcp.json for global scope):

{
  "mcpServers": {
    "codebeamer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

Claude Desktop

Edit the config file for your platform:

Platform	Path
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

{
  "mcpServers": {
    "codebeamer": {
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

Restart Claude Desktop after saving.

Cursor

Add to .cursor/mcp.json in the project root (project scope) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "codebeamer": {
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "codebeamer": {
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

VS Code (Copilot)

Add to .vscode/mcp.json in the project root:

{
  "servers": {
    "codebeamer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

Gemini CLI

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "codebeamer": {
      "command": "npx",
      "args": ["-y", "codebeamer-mcp"],
      "env": {
        "CB_URL": "https://your-instance.example.com/cb/api",
        "CB_USERNAME": "your_username",
        "CB_PASSWORD": "your_password"
      }
    }
  }
}

Alternative: global install

npm install -g codebeamer-mcp

Then use "command": "codebeamer-mcp" (no args) instead of npx in any config above.

Pinning a specific version

"args": ["-y", "codebeamer-mcp@0.2.0"]

Updates

Method	Update behavior
`npx -y codebeamer-mcp`	Always fetches the latest version
`npm install -g codebeamer-mcp`	Stays on installed version. Run `npm update -g codebeamer-mcp` to update
Pinned version (`@0.2.0`)	Never auto-updates; change the version string manually

⚠️ Never commit .mcp.json with real credentials — it is listed in .gitignore.

From source (development)

git clone https://github.com/3KniGHtcZ/codebeamer-mcp.git
cd codebeamer-mcp
npm install
npm run build

Then use "command": "node" with "args": ["dist/index.js"] in your .mcp.json.

Development & Testing

# Run tests (no real Codebeamer instance needed)
npm test

# Start the mock API server (port 3001)
node mock-server.mjs

# Interactive testing via MCP Inspector
CB_URL=http://localhost:3001 CB_USERNAME=mock CB_PASSWORD=mock \
  npx @modelcontextprotocol/inspector node dist/index.js

Configuration

Variable	Description	Default
`CB_URL`	Codebeamer API URL, e.g. `https://your-instance.example.com/cb/api` (the server appends `/v3` automatically)	(required)
`CB_USERNAME`	Login username	(required)
`CB_PASSWORD`	Password	(required)
`CB_UNSAFE_SSL`	Set to `true` to allow connections to servers with unverified/self-signed certificates	`false`
`CB_API_VERSION`	API version	`v3`
`CB_TIMEOUT_MS`	Request timeout (ms)	`30000`
`CB_MAX_ITEMS`	Max items per page	`100`

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

1wRelease cycle

9Releases (12mo)

Commit activity

Issues opened vs closed

Resources

Need Help?

Related Servers

Tools

View all tools

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/3KniGHtcZ/codebeamer-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server