# devemberx/mcp-server-polarion [Health: Active]

**Category:** 📋 Product Management  
**Repository:** https://github.com/devemberx/mcp-server-polarion  
**GitHub Stars:** 17  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/devemberx-mcp-server-polarion

## Description
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.

## Tools
Capabilities this server exposes over MCP:

- **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_attachments** — List a document's attachments with file name, size, and author
- **get_document_attachment_content** — Fetch an image attachment for viewing (bitmap as image, SVG as text)
- **list_work_item_attachments** — List a work item's attachments with file name, size, and author
- **get_work_item_attachment_content** — Fetch a work item image attachment for viewing (bitmap as image, SVG as text)
- **list_test_record_attachments** — List a test record's attachments with file name, size, and author
- **get_test_record_attachment_content** — Fetch a test record image attachment for viewing (bitmap as image, SVG as text)
- **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
- **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_attachments** — Upload one or more local files as document attachments
- **create_work_item_attachments** — Upload one or more local files as work item attachments
- **create_test_record_attachments** — Upload one or more local files as test record attachments
- **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

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "mcp-server-polarion": {
    "command": "uvx",
    "args": ["mcp-server-polarion"],
    "env": {
      "POLARION_URL": "",
      "POLARION_TOKEN": ""
    }
  }
}
```

**Requires environment variables:** `POLARION_URL`, `POLARION_TOKEN` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What devemberx/mcp-server-polarion does

devemberx/mcp-server-polarion exposes Polarion ALM through the Model Context Protocol. It covers project and document discovery, work-item lookup, test-run and test-record inspection, traceability links, comments, attachments, and selected write operations.

For reading, the server can return document metadata or render a complete document as Markdown. It can expose a document's structural parts together with embedded work-item metadata, return work-item bodies as raw HTML or Markdown, and inspect incoming or outgoing links. Search tools accept Lucene queries, while work-item searches can also use SQL. Recipe tools provide SQL examples and Polarion HTML templates for advanced queries or raw-body edits.

Write operations include creating and updating work items and documents, copying documents, and changing document structure by moving work items into or out of documents. The available interface also covers test runs and records, links, attachments, and comments as described by the repository tool listing.

## How it works

devemberx/mcp-server-polarion runs as an MCP process and communicates with a configured Polarion instance. List operations use `page_size` and `page_number` pagination, with page sizes from 1 through 100. Document and work-item content can be requested in the representation suited to the task: rendered Markdown for agent-friendly reading or raw HTML where Polarion formatting needs to be preserved or edited.

Before a write reaches Polarion, the server can run it with `dry_run`. Its pre-write checks validate fields, enum values, and link targets. Enum lookup tools help an agent resolve valid identifiers before changing document or work-item fields.

## Setup and configuration

The server requires Polarion 2506 or newer and `uv`. A typical launch uses `uvx mcp-server-polarion` with `POLARION_URL` set to the Polarion base URL and `POLARION_TOKEN` set to a personal access token.

Authentication and the target Polarion endpoint therefore depend on the URL and token settings documented above.

## Tools and capabilities

- Discover accessible projects, project documents, work items, and test runs.
- Search work items with Lucene or SQL and retrieve SQL query recipes.
- Read documents and work items as Markdown or raw HTML.
- Inspect document structure, traceability links, comments, enum options, and attachments.
- Examine test-run details, execution records, revisions, comments, and image attachments.
- Create or update work items and documents, including metadata, body content, and workflow status.
- Copy documents and reorganize work items within document structure.
- Use dry-run validation before supported writes.

## Limitations and notes

The Polarion version requirement is 2506 or later. The server operates on data available to the configured Polarion account, so accessible projects and writable resources depend on that account's permissions. Raw HTML editing requires preserving Polarion's expected formatting, for which the server supplies HTML recipes.

_Full upstream README: https://allmcps.com/mcp/devemberx-mcp-server-polarion/readme_