mcp-server-polarion 0.7.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

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

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
get_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_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)
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 a document's metadata (title / status / type) and optionally apply a workflow action; body is preserved

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