| name | confluence |
| description | Look up, read, create, update, search, and navigate Confluence pages using the confluence CLI. Use as fallback when Atlassian MCP tools are unavailable. Triggers: /confluence, "look up confluence page", "check confluence", "read confluence", "create confluence page", "update confluence page", "search confluence", "find in confluence", "confluence page", any Confluence page URL like https://veeam-vdc.atlassian.net/wiki/...
|
| argument-hint | [page ID, URL, or search query] |
| allowed-tools | ["Bash"] |
Confluence Page Management (CLI)
Use the confluence CLI to read, create, update, search, and navigate Confluence pages.
This is the fallback when Atlassian MCP tools are not available.
Veeam Context
- Confluence instance:
veeam-vdc.atlassian.net
- Common spaces:
DP (Data Pipelines), VDC, ENG
- Page URLs:
https://veeam-vdc.atlassian.net/wiki/spaces/<SPACE>/pages/<pageId>
MCP-to-CLI Mapping
When Atlassian MCP tools (Cloud ID: cb1bcab7-9522-4cf1-b2ac-8b141ee24914)
are unavailable, use these CLI equivalents:
| MCP Tool | CLI Equivalent |
|---|
getConfluencePageDescendants(cloudId, pageId, depth=1) | confluence children --show-id <pageId> |
searchConfluenceUsingCql (e.g. ancestor = <id>) | confluence search --cql "ancestor = <id>" |
getConfluencePage(cloudId, pageId) | confluence read -f markdown <pageId> |
createConfluencePage(cloudId, spaceId, title, parentId, body) | confluence create-child "<title>" <parentId> --format markdown -f <file> |
updateConfluencePage(cloudId, pageId, title, body) | confluence update <pageId> --format markdown -f <file> |
Note on folder-type pages: MCP's getConfluencePageDescendants 404s on
folder-type pages (e.g. Oncall Investigations root 1293025298). The CLI
does not have this limitation — confluence children 1293025298 works fine.
Command Reference
Reading & Navigation
| Command | Description |
|---|
confluence read <pageId> | Read page content (text by default) |
confluence read -f markdown <pageId> | Read page as markdown |
confluence read -f html <pageId> | Read page as raw HTML |
confluence info <pageId> | Get page metadata (title, ID, type) |
confluence children <pageId> | List child pages |
confluence children --show-id <pageId> | List children with page IDs |
confluence children --format tree <pageId> | List children as tree |
confluence children -r <pageId> | List all descendants recursively |
Searching
| Command | Description |
|---|
confluence search "<query>" | Text search across all spaces |
confluence search --cql "<CQL>" | Search using CQL (e.g. ancestor = <id>) |
confluence search -l 20 "<query>" | Search with custom result limit |
confluence find "<title>" | Find a page by exact title |
confluence find -s DP "<title>" | Find a page by title in a specific space |
Creating & Updating
| Command | Description |
|---|
confluence create "<title>" <spaceKey> | Create a new top-level page |
confluence create-child "<title>" <parentId> | Create a child page |
confluence create-child "<title>" <parentId> --format markdown -f <file> | Create child from markdown file |
confluence create-child "<title>" <parentId> -c "<content>" --format markdown | Create child with inline content |
confluence update <pageId> -f <file> --format markdown | Update page from file |
confluence update <pageId> -c "<content>" --format storage | Update page with storage format |
confluence update <pageId> -t "<new title>" | Rename a page |
Other Operations
| Command | Description |
|---|
confluence comments <pageId> | List comments on a page |
confluence comment <pageId> | Add a comment to a page |
confluence move <pageId> <newParentId> | Move a page to a new parent |
confluence delete <pageId> | Delete a page (use with caution) |
confluence attachments <pageId> | List attachments |
confluence attachment-upload <pageId> | Upload attachments |
confluence export <pageId> | Export page with attachments |
confluence copy-tree <srcId> <dstParentId> | Copy a page tree |
confluence spaces | List all spaces |
Navigating Page Hierarchies
Walk a page tree by listing children at each level:
confluence children --show-id 1293025298
confluence children --show-id <year-page-id>
confluence children --show-id <month-page-id>
confluence children --show-id <day-page-id>
Known page IDs (Oncall Investigations, may change over time):
- Root folder:
1293025298
- 2026 year page:
1291845743
- 04-April month page:
1290961023
Content Formats
--format markdown — for creating/updating pages with markdown content--format storage — Confluence storage format (HTML-like), needed for
advanced layouts like full-width tables with data-layout="full-width"- When writing long content, write to a temp file first and use
-f <file>
to avoid shell escaping issues
Instructions
- Extract page ID from URL (
/pages/<pageId>) or use search/find to locate it
- Run the appropriate command from the reference above
- Present results: for reads show content, for searches show titles + IDs,
for creates/updates confirm with the page URL
