confluence-mini-mcp
Crawls Confluence page trees, follows internal and external links, and caches pages as Markdown. Provides tools for searching, retrieving, listing, and refreshing cached Confluence pages.
Integrates with Slack through the nanobot framework, allowing users to search and retrieve Confluence content directly from Slack.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@confluence-mini-mcpsearch for latest engineering updates"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
confluence-mini-mcp
Lightweight MCP server that crawls Confluence subtrees and serves cached Markdown. Works with Claude Code and nanobot (Slack) via stdio.
Claude Code config
{
"mcpServers": {
"confluence-docs": {
"command": "uvx",
"args": ["--from", "git+https://github.com/bonkey/confluence-mini-mcp", "confluence-mini-mcp"],
"env": {
"CONFLUENCE_BASE_URL": "https://company.atlassian.net/wiki",
"CONFLUENCE_EMAIL": "you@company.com",
"CONFLUENCE_API_TOKEN": "...",
"CONFLUENCE_ROOT_PAGE_IDS": "123456,789012"
}
}
}
}Pin to a tag: "--from", "git+https://github.com/bonkey/confluence-mini-mcp@v0.1.1"
Related MCP server: confluence-mcp-server
Nanobot config
[mcp.confluence]
command = "uvx"
args = ["--from", "git+https://github.com/bonkey/confluence-mini-mcp", "confluence-mini-mcp"]
env = { CONFLUENCE_BASE_URL = "https://company.atlassian.net/wiki", CONFLUENCE_EMAIL = "you@company.com", CONFLUENCE_API_TOKEN = "...", CONFLUENCE_ROOT_PAGE_IDS = "123456,789012" }Tools
Tool | Description |
| Keyword search across cached pages (title 10x weight) |
| Full Markdown content by page ID (Confluence or external) |
| Index of all cached pages (optional space_key filter) |
| Force re-crawl, bypass TTL |
Crawling
The crawler walks a graph, not just a tree:
Child pages — standard parent → children traversal
Linked Confluence pages — any internal link in page content is followed (enables a single "hub page" linking to multiple subtrees)
External HTTP links — fetched as Markdown (1 level deep, follows redirects only)
In-page directives
Add a [confluence-mcp] block anywhere on a Confluence page to control crawl behaviour for that subtree:
[confluence-mcp]
max_depth=3
follow_links=false
follow_external=trueDirective | Default | Description |
| (global config) | Override crawl depth from this page down |
|
| Follow linked Confluence pages in content |
|
| Fetch external HTTP links in content |
The directive block is stripped from the Markdown output — agents never see it.
Configuration
All settings via env vars or confluence-mini-mcp.toml:
Env var | Description | Default |
| Wiki base URL | required |
| Atlassian email | required |
| API token | required |
| Comma-separated root page IDs | required |
| Cache directory |
|
| Cache max age |
|
| Max crawl depth |
|
| Max pages to crawl |
|
| Background refresh interval (0=off) |
|
| Fake cache mode, no API calls |
|
Development
just dev # run in dry-run mode
just check # format + test
just release # tag + pushThis server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/bonkey/confluence-mini-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server