confluence_read
Fetch a Confluence page by ID; returns GitHub-style JFM markdown or raw ADF JSON. Supports version history and file output.
Instructions
Fetch a Confluence page by numeric ID (e.g. "12345678"). Returns JFM markdown by default — AI-friendly GitHub-style markdown, the form to read/edit then feed back to confluence_write/confluence_create. That output carries localId attributes (and inline-comment anchor spans) that anchor inline comments and other stateful nodes — preserve them verbatim when editing so a later confluence_write does not drop those comments. Pass format="adf" for the raw ADF JSON (the on-the-wire document model) only when you need exact node structure. Pass version to read a specific historical version (an immutable snapshot) instead of the current head — useful for seeing what a reviewer was reading when they commented. When output_file is set, the content is written to that path and the tool returns a short YAML summary (path/bytes/format) — useful for large pages. This reads a single page; to fetch a whole page tree or an entire space to disk, use confluence_download instead. NOTE: inline-comment anchors do NOT follow text edits — to detect/repair drifted comments use confluence_comment_audit / confluence_comment_reanchor. Any author/version metadata is returned as Atlassian account IDs — resolve them to display names with confluence_user_get. Mirrors omni-dev atlassian confluence read.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Confluence page ID (e.g., "12345678"). | |
| format | No | Output format: `"jfm"` (default, AI-friendly markdown) or `"adf"` (raw ADF JSON). | |
| version | No | Read a specific historical version instead of the current head (e.g. `3`). Confluence stores each version as an immutable snapshot; omit for the latest. Useful for seeing what a reviewer was reading when they posted a comment. | |
| output_file | No | When set, writes the rendered content to this path and returns a short YAML summary (path/bytes/format) instead of the inline body. Useful for large pages that would otherwise blow past the context window — the assistant can then read the file with offset/limit. |