mcp-server-polarion — Polarion ALM MCP server
An MCP server that lets an AI assistant read and modify Polarion ALM documents, work items and test runs.
claude mcp add --env POLARION_URL=<POLARION_URL> --env POLARION_TOKEN=<POLARION_TOKEN> --env POLARION_MAX_REQUESTS_PER_SECOND=<POLARION_MAX_REQUESTS_PER_SECOND> --transport stdio mcp-server-polarion -- uvx mcp-server-polarionWhat mcp-server-polarion does
Documents come back as Markdown, work items can be listed and updated, and test runs with their execution records get their own tools. Traceability links, comments and attachments are covered too.
Writes go through dry_run first, and guards check fields, enum values and link targets before anything reaches Polarion. Requests are queued under a rate cap you set, with retries on 429 and 5xx responses. That makes production data a reasonable target for an assistant.
You need Polarion 2506+ and uv. The instance address and a personal access token go into POLARION_URL and POLARION_TOKEN; skip them and the server has nothing to connect to. POLARION_MAX_REQUESTS_PER_SECOND controls the pacing.
What it helps with
- render a Polarion document as Markdown for review
- create several work items in one call
- update work item fields and status without clicking through the UI
- walk incoming and outgoing traceability links
- move a work item into another document section
Example prompts for the agent
- Pull the requirements document from the project and outline its sections
- Create three work items of type requirement and attach them to the document
- Run the test run status update as
dry_runand show me the diff
How to install mcp-server-polarion
Platform CLI
claude mcp add --env POLARION_URL=<POLARION_URL> --env POLARION_TOKEN=<POLARION_TOKEN> --env POLARION_MAX_REQUESTS_PER_SECOND=<POLARION_MAX_REQUESTS_PER_SECOND> --transport stdio mcp-server-polarion -- uvx mcp-server-polarionReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-server-polarion <command>
Platform CLI
codex mcp add mcp-server-polarion --env POLARION_URL=<POLARION_URL> --env POLARION_TOKEN=<POLARION_TOKEN> --env POLARION_MAX_REQUESTS_PER_SECOND=<POLARION_MAX_REQUESTS_PER_SECOND> -- uvx mcp-server-polarionReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-server-polarion <command>
Config file
{
"mcpServers": {
"mcp-server-polarion": {
"command": "uvx",
"args": [
"mcp-server-polarion"
],
"env": {
"POLARION_URL": "<POLARION_URL>",
"POLARION_TOKEN": "<POLARION_TOKEN>",
"POLARION_MAX_REQUESTS_PER_SECOND": "<POLARION_MAX_REQUESTS_PER_SECOND>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-server-polarion <command>
Config file
{
"servers": {
"mcp-server-polarion": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-server-polarion"
],
"env": {
"POLARION_URL": "<POLARION_URL>",
"POLARION_TOKEN": "<POLARION_TOKEN>",
"POLARION_MAX_REQUESTS_PER_SECOND": "<POLARION_MAX_REQUESTS_PER_SECOND>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-server-polarion <command>
Platform CLI
gemini mcp add -e POLARION_URL=<POLARION_URL> -e POLARION_TOKEN=<POLARION_TOKEN> -e POLARION_MAX_REQUESTS_PER_SECOND=<POLARION_MAX_REQUESTS_PER_SECOND> mcp-server-polarion uvx mcp-server-polarionReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-server-polarion <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-server-polarion
How do I install mcp-server-polarion in Claude Code?
Run claude mcp add mcp-server-polarion -e POLARION_URL=<POLARION_URL> -e POLARION_TOKEN=<POLARION_TOKEN> -- uvx mcp-server-polarion, with your own instance URL and token filled in.
What does mcp-server-polarion do?
It connects an AI assistant to Polarion ALM so it can read documents, work items, test runs and links, and write changes back through MCP tools.
What does the server need to run?
Polarion 2506+ and uv on the machine. The server also needs a personal access token and the instance URL as environment variables.
