# polarion-mcp

MCP server for Claude Code and Codex connecting AI agents to the Polarion ALM REST API. Finds requirements, inspects LiveDocs, and prepares test runs.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 repo stars
- Author: phillipboesger
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/phillipboesger/polarion-mcp
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/polarion-mcp

## What it does

The server converts client tool calls into Polarion REST requests, exposing 284 tools. It lets agents query requirements, defect records, document contents, and traceability links using operations like `getWorkItems` and `getLinkedWorkItems`.

Write operations support dry runs via `dry_run: true` before applying modifications. Setting `MCP_READ_ONLY=1` blocks all write actions. The server does not execute tests directly: it creates run definitions and records test outcomes supplied by the user.

Running the connector requires a Polarion instance with REST enabled, a personal token in `BEARER_TOKEN`, the host address in `API_BASE_URL`, and Node.js 22 or newer.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `API_BASE_URL`, `BEARER_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add polarion-mcp -e API_BASE_URL=<API_BASE_URL> -e BEARER_TOKEN=<BEARER_TOKEN> -- npx -y polarion-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add polarion-mcp --env API_BASE_URL=<API_BASE_URL> --env BEARER_TOKEN=<BEARER_TOKEN> -- npx -y polarion-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "polarion-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "polarion-mcp"
            ],
            "env": {
                "API_BASE_URL": "<API_BASE_URL>",
                "BEARER_TOKEN": "<BEARER_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "polarion-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "polarion-mcp"
            ],
            "env": {
                "API_BASE_URL": "<API_BASE_URL>",
                "BEARER_TOKEN": "<BEARER_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e API_BASE_URL=<API_BASE_URL> -e BEARER_TOKEN=<BEARER_TOKEN> polarion-mcp npx -y polarion-mcp
```
Replace <…> with your own values

## When to use it
- locate requirements lacking verification links
- inspect LiveDoc sections and propose text revisions
- draft test cases and structure new test runs
- filter open blocking defects for an upcoming release

## Example prompts
- Find requirements without a verifies link to a test case.
- Which open defects could block this release plan?

## Similar
- [mcp-server-polarion](https://affpapa.org/en/nevibecode/mcp/mcp-server-polarion.md) — MCP server · ★ 17 repo stars
- [Bugasura](https://affpapa.org/en/nevibecode/mcp/bugasura.md) — MCP server
- [testrail](https://affpapa.org/en/nevibecode/skills/testrail.md) — skill · 1581 installs
- [speckit-analyze](https://affpapa.org/en/nevibecode/skills/speckit-analyze.md) — skill · 1600 installs
- [Qase Test Management](https://affpapa.org/en/nevibecode/mcp/qase-test-management.md) — MCP server · ★ 37 repo stars
- [sdp-remote-mcp](https://affpapa.org/en/nevibecode/mcp/sdp-remote-mcp.md) — MCP server · ★ 2 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
