Open Source · MIT License

polarion-mcp

Connect your AI to Polarion in minutes.
271 REST operations. One server. Every client.

TypeScript
Node.js 20+
Polarion REST API
Star on GitHub Read the Blog Post ↗
$ install claude mcp add polarion-mcp -e API_BASE_URL=... -e BEARER_TOKEN=...
Explore
271 REST Operations
5 AI Clients
3 Transports
MIT License

See it in action

Your AI, inside Polarion

Ask questions in plain language. Get real data from your Polarion instance in seconds — no API knowledge required.

GitHub Copilot queries Polarion work items via polarion-mcp in VS Code
Cloud AI assistant queries Polarion in the browser — no developer skills needed
polarion-mcp · tool response
You › List all open defects in the DEMO project assigned to me
// polarion-mcp calls getWorkItems
project: "DEMO", type: "defect", status: "open", assignedTo: "me"
✓ Found 3 open defects assigned to you:
DEMO-421 · High · Login page crashes on Safari mobile
DEMO-435 · Medium · Export dialog does not close after save
DEMO-447 · Critical · NullPointerException in report generator
// Copilot: Want me to open DEMO-447 in Polarion and suggest a fix?

What it does

Everything Polarion, AI-native

One MCP server that turns the entire Polarion REST API into tool calls your AI assistant can use directly.

🔌
271 REST Operations

Every Polarion REST endpoint exposed as a typed tool — work items, test runs, documents, plans, users, and more. Full coverage, auto-generated from the OpenAPI spec.

auto-generated
🤖
Every Major AI Client

Claude Code, Claude Desktop, VS Code GitHub Copilot, ChatGPT Custom GPT, Claude.ai web — one server, five clients, three transports. Pick your stack.

stdio · http · streamable
🐳
Docker-Ready

Multi-transport container image with configurable entrypoints. Run locally or deploy on your own infrastructure. No cloud dependency.

self-hosted
📚
SDK Documentation Access

Optional Polarion SDK docs loaded as tool context. Your AI understands not just the REST API, but the Polarion programming model.

in-context docs
🔒
Secure by Design

Personal Access Tokens stored in .env, gitignored by default. Separate API keys per transport. TLS support with cert bypass only for internal servers.

pat · env · tls
⚡
Cached Project Config

Project-level configuration is cached on first use. Your AI stays fast even when exploring a complex Polarion instance with dozens of projects.

performance

Setup

Up and running in 3 steps

01
Clone & Build

Clone the repo, install dependencies, and build. Takes less than two minutes.

npm install && npm run build
02
Configure

Add your Polarion URL and Personal Access Token. Point your AI client to the server.

API_BASE_URL + BEARER_TOKEN
03
Ask

Open your AI assistant and start querying Polarion in plain language. No API knowledge required.

"List open defects in PROJECT"

Compatibility

Works with your tools

One server, every client. Pick the AI assistant you already use.

🤖
Claude Code
CLI / Agent
stdio
💬
Claude Desktop
macOS / Windows
stdio
🔵
GitHub Copilot
VS Code Agent Mode
stdio
✦
ChatGPT
Custom GPT
rest http
🌐
Claude.ai
Web App
streamable http

Quick Start

Get connected

Choose your AI client. Copy the config. You're done.

claude mcp add polarion-mcp \
  -e API_BASE_URL=https://your-polarion/polarion \
  -e BEARER_TOKEN=your-personal-access-token \
  -- node /path/to/polarion-mcp/build/index.js
// .vscode/mcp.json
{
  "servers": {
    "polarion-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/polarion-mcp/build/index.js"],
      "env": {
        "API_BASE_URL": "https://your-polarion/polarion",
        "BEARER_TOKEN": "your-personal-access-token"
      }
    }
  }
}
// claude_desktop_config.json
{
  "mcpServers": {
    "polarion-mcp": {
      "command": "node",
      "args": ["/path/to/polarion-mcp/build/index.js"],
      "env": {
        "API_BASE_URL": "https://your-polarion/polarion",
        "BEARER_TOKEN": "your-personal-access-token"
      }
    }
  }
}
docker run -d \
  -e API_BASE_URL=https://your-polarion/polarion \
  -e BEARER_TOKEN=your-personal-access-token \
  -e MCP_HTTP_TOKEN=your-mcp-secret \
  -p 3000:3000 \
  ghcr.io/phillipboesger/polarion-mcp:latest
Phillip Bösger

Built by Phillip Bösger

Polarion & AI Freelancer · Bösger Digital

Nearly a decade of Polarion experience. I built polarion-mcp because I wanted my AI assistants to actually know what's happening in Polarion — not just talk about it.

📝 Polarion Blog 💼 LinkedIn GitHub

Ready to connect your AI to Polarion?

Open-source, self-hosted, and ready in minutes. No vendor lock-in.

View on GitHub Read the Blog ↗