devemberx/mcp-server-polarion
FreeNot checkedPolarion ALM integration with 24 read/write tools for documents, work items, traceability links, and comments. Renders documents as Markdown, searches with Luce
About
Polarion ALM integration with 24 read/write tools for documents, work items, traceability links, and comments. Renders documents as Markdown, searches with Lucene or SQL, walks incoming/outgoing links, and creates/updates/reorganizes work items. Every write tool supports dryrun with pre-write field, enum, and link-target validation. Requires Polarion 2506+. uvx mcp-server-polarion.
README
mcp-server-polarion
Talk to your Polarion — AI reads, writes, and reorganizes documents, work items, test runs, and traceability links.
Features · Quickstart · Tools · Example Prompts · Setup
A Model Context Protocol (MCP) server for Polarion ALM, built for real-world instances: every write supports dry_run, guards validate fields and enum values before anything is committed, and requests are automatically paced to Polarion's rate limits — so an AI assistant can work on production data without surprises.

Features
- 37 tools covering read and write across documents, work items, test runs, traceability links, and comments.
- Read — render documents as Markdown, search with Lucene or SQL, walk incoming/outgoing links, resolve enum options.
- Write — create and update work items, documents, and test runs, manage links, reorganize document structure, post comments.
- Safe writes — every write tool supports
dry_run, and pre-write guards validate fields, enum values, and link targets before hitting Polarion. - Plays nice with your server — requests are paced to Polarion's rate limits, with automatic retries on 429/5xx responses.
- Built for LLMs — strict async, fully typed, pagination on every list tool, docstrings written as the assistant's manual.
Quickstart
Requires Polarion 2506+ and uv — see Prerequisites. Fastest path — Claude Code:
claude mcp add mcp-server-polarion \
-e POLARION_URL=https://polarion.example.com \
-e POLARION_TOKEN=your-personal-access-token \
-- uvx mcp-server-polarion
Other clients (VS Code, Claude Desktop, Cursor) — see Client Configuration.
Tools
Read
| Tool | Description |
|---|---|
list_projects |
List accessible projects |
list_documents |
List documents in a project |
list_work_items |
List work items in a project (Lucene/SQL query) |
list_test_runs |
List test runs in a project (Lucene query, templates filter) |
get_test_run |
Get test run details, optionally with the raw HTML report body |
list_test_records |
List a test run's execution records, one per test case iteration |
get_test_record |
Get one test record's execution comment and test-case revision |
get_sql_query_recipes |
Fetch copy-paste SQL recipes for advanced queries |
get_html_recipes |
Fetch copy-paste Polarion HTML templates for raw-HTML body edits |
get_document |
Get document metadata, optionally with the raw body HTML |
read_document |
Render a document end-to-end as Markdown |
read_document_parts |
List a document's structural parts with embedded work item metadata |
get_work_item |
Get work item details with the body as raw HTML |
read_work_item |
Get work item details with the body as Markdown |
list_work_item_links |
List a work item's outgoing or incoming links |
list_document_comments |
List a document's comments with thread relationships |
list_work_item_comments |
List a work item's comments with thread relationships |
list_document_enum_options |
Resolve valid enum ids for a document field |
list_work_item_enum_options |
Resolve valid enum ids for a work item field |
All list tools support pagination via page_size (1–100) and page_number parameters.
Write
| Tool | Description |
|---|---|
create_work_items |
Create one or more work items in a single request |
update_work_items |
Update fields, body, or workflow status on one or more work items |
create_document |
Create a new document |
update_document |
Update document metadata, body, or workflow status |
copy_document |
Copy a document to a new name, space, or project |
create_test_runs |
Create one or more test runs, optionally from a template |
create_test_records |
Record test-case execution results on a test run |
update_test_runs |
Update title, status, group, or custom fields on one or more test runs |
update_test_records |
Update result, comment, or defect link on one or more test records of a test run |
create_work_item_links |
Create one or more outgoing links from a source work item |
update_work_item_link |
Update suspect / revision on one outgoing link |
delete_work_item_links |
Delete one or more outgoing links from a source work item |
move_work_item_to_document |
Attach a work item to a document at a chosen position |
move_work_item_from_document |
Detach a work item from its document |
create_document_comments |
Add one or more comments or replies to a document |
create_work_item_comments |
Add one or more comments or replies to a work item |
update_document_comment |
Resolve or re-open a document comment |
update_work_item_comment |
Resolve or re-open a work item comment |
Example Prompts
Discovery & search
"List the projects I can access, then show the documents in project MCPT with their types."
"List the documents in space 'Specifications' of project MCPT."
"Find every approved requirement in project MCPT whose title starts with 'Auth' and show me their owning document."
"Search project MCPT for work items where the custom field 'verification_method' is 'Test' — grab the SQL recipes first if you need a join."
"Find all work items in the SRS module of project MCPT that were changed in the last sprint."
Reading & summarizing
"Read the SRS document of project MCPT and summarize each open requirement."
"Show me the structural outline of the SRS document — headings and the work items under each."
"Read work item MCPT-042 as Markdown and explain what it asks for."
"Show the outgoing and incoming links for MCPT-042 and flag any child task that is still open."
"Which requirements in the SRS document have no 'verifies' back link from a test case?"
"List the open comment threads on the SRS document and who started each."
Creating & editing
"Create a task in project MCPT titled 'Refactor authentication module' and link it to MCPT-042 as 'relates_to'."
"Create three test-case work items in project MCPT from this checklist and link each one to MCPT-042 as 'verifies'."
"Add a new requirement under section 3.2 of the SRS document with the body I just drafted."
"Update the description of MCPT-042 with the revised text I'll paste, keeping the existing formatting."
"Add a comment on the SRS document asking the owner to clarify section 4, then reply to thread T-12 marking it resolved."
"Create a test run REG-SPRINT-7 in project MCPT from the 'Regression' template with status 'open'."
Workflow & reorganization
"List the valid status values for a defect in project MCPT, then move MCPT-077 to 'in_review'."
"Bump MCPT-042's priority to 90, set severity to 'major', and approve the workflow."
"Change MCPT-201 from a task to a requirement and re-apply its previous status."
"Move MCPT-201 into the SRS document right after MCPT-150."
"Detach MCPT-077 from its document so I can rework it as a standalone task."
"Mark the 'blocks' link from MCPT-042 to MCPT-099 as suspect, then delete the stale 'relates_to' link to MCPT-010."
Setup
Prerequisites
Polarion 2506 or higher is required. Earlier versions lack REST API endpoints this server depends on.
This server is distributed as a Python package and requires uv to run.
Install uv (if not already installed):
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Or via pip:
pip install uv
No other installation is needed — uvx mcp-server-polarion downloads and runs the server automatically.
Environment Variables
| Variable | Description | Example |
|---|---|---|
POLARION_URL |
Base URL of your Polarion instance | https://polarion.example.com |
POLARION_TOKEN |
Personal Access Token for authentication | your-personal-access-token |
To generate a Personal Access Token, open Polarion, click your user name, and go to My Account → Personal Access Tokens.
Client Configuration
VS Code (GitHub Copilot)
Add to .vscode/mcp.json:
{
"servers": {
"mcp-server-polarion": {
"type": "stdio",
"command": "uvx",
"args": ["mcp-server-polarion"],
"env": {
"POLARION_URL": "https://polarion.example.com",
"POLARION_TOKEN": "your-personal-access-token"
}
}
}
}
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"mcp-server-polarion": {
"command": "uvx",
"args": ["mcp-server-polarion"],
"env": {
"POLARION_URL": "https://polarion.example.com",
"POLARION_TOKEN": "your-personal-access-token"
}
}
}
}
Cursor
Add to Cursor MCP settings:
{
"mcpServers": {
"mcp-server-polarion": {
"command": "uvx",
"args": ["mcp-server-polarion"],
"env": {
"POLARION_URL": "https://polarion.example.com",
"POLARION_TOKEN": "your-personal-access-token"
}
}
}
}
Claude Code
Register via the claude mcp add command:
claude mcp add mcp-server-polarion \
-e POLARION_URL=https://polarion.example.com \
-e POLARION_TOKEN=your-personal-access-token \
-- uvx mcp-server-polarion
Contributing
Bug reports and pull requests are welcome — see CONTRIBUTING.md for branch, commit, and review conventions.
License
Install devemberx/mcp-server-polarion in Claude Desktop, Claude Code & Cursor
unyly install devemberx-mcp-server-polarionInstalls into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.
First time? Get the CLI: curl -fsSL https://unyly.org/install | sh
Or configure manually
Run in your terminal:
claude mcp add devemberx-mcp-server-polarion -- uvx mcp-server-polarionFAQ
Is devemberx/mcp-server-polarion MCP free?
Yes, devemberx/mcp-server-polarion MCP is free — one-click install via Unyly at no cost.
Does devemberx/mcp-server-polarion need an API key?
No, devemberx/mcp-server-polarion runs without API keys or environment variables.
Is devemberx/mcp-server-polarion hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install devemberx/mcp-server-polarion in Claude Desktop, Claude Code or Cursor?
Open devemberx/mcp-server-polarion on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
wenb1n-dev/SmartDB_MCP
A universal database MCP server supporting simultaneous connections to multiple databases. It provides tools for database operations, health analysis, SQL optim
by wenb1n-devPostgres Server
This server enables interaction with PostgreSQL databases through the Model Context Protocol, optimized for the AWS Bedrock AgentCore Runtime. It provides tools
by madhurprashPostgres
Query your database in natural language
by AnthropicPostgreSQL
Read-only database access with schema inspection.
by modelcontextprotocolCompare devemberx/mcp-server-polarion with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All data MCPs
