Confluence Integration

Pro v1.0.0

Manage Confluence pages, spaces, and content programmatically through the Atlassian API

Requires Claude Code CLI

This skill integrates with Confluence through Claude Code. Install Claude Code and add this skill to use it.

Available Actions

Get Page

Retrieve a page by space key and title, including content and metadata

Parameters

Name Type Required Description
space string Required Space key (e.g., 'DOCS', 'TEAM')
title string Required Exact page title (case-sensitive)

Returns

object Page object with id, title, body, version, and metadata

Try saying...

  • "Get the 'Team Guidelines' page from the DOCS space"
  • "Retrieve the API documentation page from TECH space"
  • "Show me the content of 'Meeting Notes' in TEAM"

Create Page

Create a new page in a specified space

Parameters

Name Type Required Description
space string Required Space key where page will be created
title string Required Title for the new page
body string Required Page content in Confluence storage format (HTML)

Returns

object Created page object with id and URL

Try saying...

  • "Create a new page called 'Meeting Notes' in TEAM space"
  • "Add a page titled 'API Guide' to the DOCS space"
  • "Create a new documentation page in the TECH space"

Update Page

Update an existing page's title and content

Parameters

Name Type Required Description
page_id string Required Confluence page ID
title string Required New title for the page
body string Required New content in Confluence storage format

Returns

object Updated page object

Try saying...

  • "Update page 123456 with new content"
  • "Change the title and body of page 789012"
  • "Modify the meeting notes page"

Search Content

Search for content using Confluence Query Language (CQL)

Parameters

Name Type Required Description
query string Required Search query text

Returns

array Array of matching content with titles, IDs, and excerpts (max 20 results)

Try saying...

  • "Search for pages about API documentation"
  • "Find all content mentioning 'security guidelines'"
  • "Search Confluence for meeting notes"

List Spaces

Get all spaces you have access to

Returns

array Array of space objects with keys, names, and descriptions

Try saying...

  • "List all Confluence spaces"
  • "Show me all spaces I can access"
  • "What spaces are available in Confluence?"

Get Space Info

Get detailed information about a specific space

Parameters

Name Type Required Description
space_key string Required Space key

Returns

object Space object with description, homepage, and metadata

Try saying...

  • "Get information about the DOCS space"
  • "Show me details for the TEAM space"
  • "What's in the TECH space?"

List Pages in Space

Get all pages from a specific space

Parameters

Name Type Required Description
space string Required Space key

Returns

array Array of page objects with titles, IDs, and version info (max 100)

Try saying...

  • "List all pages in the TEAM space"
  • "Show me all pages in DOCS"
  • "What pages are in the TECH space?"

Delete Page

Delete a page by ID (moves to trash)

Parameters

Name Type Required Description
page_id string Required Page ID to delete

Returns

string Success message

Try saying...

  • "Delete page 123456"
  • "Remove the page with ID 789012"
  • "Delete the old meeting notes page"

Getting Started

API Key Easy Setup
  1. 1 Go to https://id.atlassian.com/manage-profile/security/api-tokens
  2. 2 Click 'Create API token'
  3. 3 Give it a descriptive name (e.g., 'Claude Code Confluence Access')
  4. 4 Copy the token (shown only once)
  5. 5 Add to shell config: echo 'export CONFLUENCE_EMAIL="your.email@example.com"' >> ~/.zshrc
  6. 6 Add to shell config: echo 'export CONFLUENCE_API_TOKEN="YOUR_TOKEN"' >> ~/.zshrc
  7. 7 Add to shell config: echo 'export CONFLUENCE_URL="https://your-domain.atlassian.net"' >> ~/.zshrc
  8. 8 Restart terminal or run: source ~/.zshrc

Verify Setup

python scripts/client.py list-spaces

Success: JSON array of accessible spaces

View full setup guide

Security & Access

Access Scope

API token has same permissions as your Atlassian account. Can read all accessible content, create/update/delete pages in spaces with edit permissions, and access user information.

  • Never commit API tokens to version control
  • API tokens expire after one year by default (for enhanced security)
  • Tokens grant full account access - consider service accounts for production
  • Store credentials in shell config (~/.zshrc), never in project files
  • Rotate tokens regularly following your organization's security policies
  • Delete operations are recoverable from trash but should be used carefully

Limitations

  • API tokens expire after one year for security (tokens created after Dec 2024)
  • Limited to 100 results for list operations (spaces, pages)
  • Search returns maximum 20 results
  • Page content must be in Confluence storage format (HTML-like)
  • Delete operations move to trash, not permanent deletion

Get This Skill

Requires Pro subscription ($9/month)

Quick Reference

Type
PYTHON_SDK
Auth
API Key
Setup
Easy Setup
Tools Required
Bash
Python Dependencies
atlassian-python-api>=4.0.0

Documentation

Have Feedback?

Help us improve this skill by sharing your ideas and suggestions.

Request Improvements