Confluence MCP Server

List all available Confluence spaces. Best used as the first step in a content discovery workflow. Returns space IDs, names, and keys that you can use with other tools. TIP: Use a higher limit (e.g., 100) on first call to get a comprehensive view of available spaces.

Get details about a specific space

List all pages in a Confluence space. Best used when you need to explore all content in a specific space rather than searching for specific terms. Returns page IDs, titles, and metadata. TIP: Use this when search_confluence_pages might miss relevant pages or when you need a complete inventory of pages in a space.

Get a specific Confluence page by its ID. Returns the complete page content in markdown format, along with metadata like version history and space information. The page ID can be found in search results, page listings, or other API responses. TIP: Save page IDs from searches for direct access to frequently needed pages.

Find and retrieve a Confluence page by its title. Returns the page content in markdown format, along with metadata. Optionally specify a spaceId to narrow the search. If multiple pages match the title, returns a list of matches to choose from. TIP: Use this when you know the exact page title, but prefer search_confluence_pages for partial matches.

Create a new page in a space

Update an existing page

Search across Confluence pages using simple text or CQL (Confluence Query Language).

Query Types:

1. Simple Text Search:
   • Just provide the search term directly (e.g., "documentation")
   • The system automatically wraps it in proper CQL syntax
2. Advanced CQL Search:
   • Must include "type =" to signal raw CQL usage
   • Examples:
     • type = "page" AND text ~ "project"
     • type = "page" AND space.key = "TEAM"
     • type = "page" AND created >= "2024-01-01"

Search Capabilities:

• Full text search across all pages
• Space-specific searches
• Content type filtering
• Metadata-based filtering

CQL Operators (for advanced queries):

• ~ : contains
• = : equals
• != : not equals
• AND, OR : combine conditions
• () : group conditions

• = <= : date comparisons

• IN : multiple values

Common Search Patterns:

• Finding pages in specific space: type = "page" AND space.key = "SPACENAME" AND text ~ "searchterm"
• Finding recent pages: type = "page" AND created >= "2024-01-01" AND text ~ "searchterm"
• Finding pages by title: type = "page" AND title ~ "exactname"
• Finding pages by label: type = "page" AND label = "labelname"

Response includes:

• Page ID, title, and type
• Space information
• URL to the page
• Last modified date
• Content excerpt with search term highlighting

Pagination:

• Use 'limit' to control results per page (default: 25)
• Use 'start' for pagination offset

Workflow Tips:

1. Start with list_confluence_spaces to get space keys
2. Use space-specific searches for better results
3. Use the returned pageId with get_confluence_page for full content
4. Look for highlighted excerpts in results to identify most relevant matches

Best Practices:

1. Start with simple text searches when possible
2. Use advanced CQL (with 'type =') for complex queries
3. Use space-specific searches for better performance
4. Use get_confluence_page to fetch full content of found pages

Get labels for a page. Use this to understand page categorization and find related content through common labels.

Add a label to a page. Labels help organize content and make it easier to find related pages through search_confluence_pages.

Label Format:

• Must contain only letters, numbers, hyphens, and underscores
• No spaces or special characters allowed

Error Handling:

• Returns 400 for invalid label format
• Returns 403 for insufficient permissions
• Returns 404 if page not found
• Returns 409 if label already exists on the page

Response includes:

• Success status
• Label details (id, name, prefix, creation date)
• Operation message

Remove a label from a page.

Error Handling:

• Returns 403 for insufficient permissions
• Returns 404 if page or label not found

Response includes:

• Success status
• Operation details (pageId, label, operation type)
• Success message