CwikiMCP

MCP server for the Apache Incubator Confluence space:

https://cwiki.apache.org/confluence/display/INCUBATOR

The server is read-only and works against public wiki pages.

GET responses are cached locally by default for 30 days. Use force_refresh=true on read tools to bypass the cache for a single call.

Install

python3 -m venv .venv
. .venv/bin/activate
pip install -e .

Run

incubator-cwiki-mcp

For local development:

python -m incubator_cwiki_mcp.server

Test

pip install -e ".[dev]"
make check

Configure With Codex or Claude Desktop

Use the Python module entrypoint:

{
  "mcpServers": {
    "incubator-cwiki": {
      "command": "<Path to CwikiMCP>/.venv/bin/python",
      "args": ["-m", "incubator_cwiki_mcp.server"],
      "env": {
        "CWIKI_BASE_URL": "https://cwiki.apache.org/confluence",
        "CWIKI_SPACE_KEY": "INCUBATOR"
      }
    }
  }
}

Tools

• cwiki_space_info: return metadata for the configured Confluence space.
• cwiki_list_pages: list pages in the Incubator space.
• cwiki_search_pages: search pages with Confluence CQL. Use title_only=true to match page titles only (faster and more precise for finding a specific page by name).
• cwiki_get_page: fetch a page by title or page_id.
• cwiki_get_children: list child pages for a page_id.
• cwiki_cache_info: show local cache settings and size.
• cwiki_clear_cache: clear the local cache.

Environment

• CWIKI_BASE_URL: defaults to https://cwiki.apache.org/confluence.
• CWIKI_SPACE_KEY: defaults to INCUBATOR.
• CWIKI_CACHE_DIR: defaults to .cache/cwiki.
• CWIKI_CACHE_TTL_SECONDS: defaults to 2592000 seconds (30 days). Set to 0 to disable caching.