Content
# Confluence Markdown MCP
This is a MCP for Confluence. It allows you to convert Confluence pages to Markdown.
## Requirements
- Node.js 22+
- Macbook with ARM64 architecture (if you want to use something else, [read this](#using-other-platforms))
## Usage
Download the repository and build it once:
```bash
git clone https://github.com/svenliebig/confluence-markdown-mcp.git
cd confluence-markdown-mcp
npm install
npm run build
```
And add this to you `.cursor/mcp.json` file:
```json
{
"mcpServers": {
"confluence-markdown": {
"command": "node",
"args": [
"/path/to/confluence-markdown-mcp/build/index.js"
]
}
}
}
```
## Environment Variables
- `CONFLUENCE_USERNAME`: The username for the Confluence API.
- `CONFLUENCE_API_TOKEN`: The token for the Confluence API.
- `CONFLUENCE_URL`: The base URL for the Confluence API.
## Using Other Platforms
Currently this MCP is locked on ARM because of the `markitdown` binary in [src/tools/markitdown.ts](src/tools). You have two options:
1. Build the `markitdown` binary for your platform and replace the existing one.
2. Extend the MCP to use different `markitdown` binaries based on the platform -> AND 1. PRs are welcome! 👋🏻