mcp-server-polarion 0.8.0

MCP server for Polarion ALM — read and write documents and work items

mcp-server-polarion

A Model Context Protocol (MCP) server for Polarion ALM. Lets AI assistants read documents, work items, and traceability links — and create, update, and reorganize work items — directly from your Polarion instance.

Prerequisites

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.

---

Setup

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
POLARION_VERIFY_SSL	Verify TLS certificates (default true). Set false for self-signed certs on trusted networks.	true

MCP client env objects must use string values, so booleans are quoted (e.g. "POLARION_VERIFY_SSL": "true"). The server parses "true" / "false" into a real bool.

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",
        "POLARION_VERIFY_SSL": "true"
      }
    }
  }
}

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",
        "POLARION_VERIFY_SSL": "true"
      }
    }
  }
}

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",
        "POLARION_VERIFY_SSL": "true"
      }
    }
  }
}

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 \
  -e POLARION_VERIFY_SSL=true \
  -- uvx mcp-server-polarion

Tools

Read

Tool	Description
list_projects	List all accessible Polarion projects (supports Lucene query filtering)
list_documents	List documents in a project (with optional name/space filtering)
read_document	Render a document end-to-end as flowing Markdown
get_document	Get document metadata (title / type / status); optionally returns the raw homePageContent source for round-trip editing
read_document_parts	List structural parts with linked work-item metadata (type, status, external flag) — use for part IDs and structural traversal, not for reading
list_document_enum_options	List the valid enum values (id / name / default / hidden / terminal) for a document field on a given document type — resolve allowed status / type / custom enum ids before calling update_document
list_work_item_enum_options	List the valid enum values for a work item field on a given work item type — resolve allowed type / status / severity / priority / custom enum ids before calling create_work_item / update_work_item
list_work_items	Search work items with Lucene queries; results include priority, last-modified time, owning document, and assignees
get_work_item	Get full work item details (description, author, created/updated timestamps, severity, resolution, outline number, hyperlinks); body is raw Polarion HTML for round-trip editing
read_work_item	Same metadata as get_work_item, with the body rendered as Markdown instead of raw HTML — read-only synthesis for LLM consumption
get_linked_work_items	Get forward and back links with each linked item's type, status, and owning document for traceability analysis

All list tools support pagination via page_size (1–100) and page_number parameters.

Write

Tool	Description
create_work_item	Create a new work item
update_work_item	Update an existing work item
move_work_item_to_document	Move an existing work item into a Polarion document at a specific outline position
update_document	Update document metadata (title / status / type), optionally the body (home_page_content_html), and apply workflow actions

Example Prompts

"List all projects in Polarion"

"Show me the documents in project MCPT"

"Read the Software Requirement Specification document in project MCPT"

"Find all approved requirements in project MCPT"

"What work items are linked to MCPT-001?"

"Create a task in project MCPT titled 'Refactor authentication module'"

"Update MCPT-042's status to approved and bump priority to 90."

"Move work item MCPT-042 to the appropriate section of the SRS document."

"Mark the SRS document of project MCPT as approved."

License

MIT