{"_id":"@aiondadotcom/mcp-confluence-server","_rev":"7-72d634f32d0b58fb86e6956dee6a0af2","name":"@aiondadotcom/mcp-confluence-server","dist-tags":{"latest":"1.1.5"},"versions":{"1.0.0":{"name":"@aiondadotcom/mcp-confluence-server","version":"1.0.0","keywords":["mcp","confluence","atlassian","server","model-context-protocol","api"],"author":{"name":"Aionda"},"license":"MIT","_id":"@aiondadotcom/mcp-confluence-server@1.0.0","maintainers":[{"name":"stephanferraro","email":"stephan.ferraro@aionda.com"}],"homepage":"https://github.com/AiondaDotCom/mcp-confluence","bugs":{"url":"https://github.com/AiondaDotCom/mcp-confluence/issues"},"bin":{"mcp-confluence-server":"dist/index.js"},"dist":{"shasum":"44fa61235ee4a5c8d64795434c5cf0f11d954e25","tarball":"https://registry.npmjs.org/@aiondadotcom/mcp-confluence-server/-/mcp-confluence-server-1.0.0.tgz","fileCount":32,"integrity":"sha512-Z4NT6HERYzr4jV3UFYZLXCRr/Rq/yoygy4luxYupyt7IU8bXM8aoSr8RR1aJCKTpvJXGFV0uwos1XzlgbKkwkA==","signatures":[{"sig":"MEUCIHRyhG+ytG/fhtiDjlK/ycunixjW5L6a5VevBoSNjkmgAiEArZnSHlry4PiwMfb7RNF9A1NJ1XLxAFNnaxb77jYFxLo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":89422},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"7b7b97f45a7ad12cf32b77cedb659c7a08f011fb","scripts":{"dev":"ts-node --esm src/index.ts","lint":"eslint src/**/*.ts","test":"jest","build":"tsc","start":"node dist/index.js","format":"prettier --write src/**/*.ts","test:watch":"jest --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"stephanferraro","actor":{"name":"stephanferraro","type":"user","email":"stephan.ferraro@aionda.com"},"email":"stephan.ferraro@aionda.com"},"repository":{"url":"git+https://github.com/AiondaDotCom/mcp-confluence.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for Confluence API integration with Atlassian Cloud","directories":{},"_nodeVersion":"22.16.0","dependencies":{"zod":"^3.22.0","axios":"^1.6.0","fs-extra":"^11.2.0","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","eslint":"^8.57.0","ts-node":"^10.9.0","prettier":"^3.2.0","typescript":"^5.0.0","@types/jest":"^29.5.0","@types/node":"^20.0.0","@types/fs-extra":"^11.0.0","@typescript-eslint/parser":"^7.0.0","@typescript-eslint/eslint-plugin":"^7.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-confluence-server_1.0.0_1752162927286_0.3212766816596353","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@aiondadotcom/mcp-confluence-server","version":"1.1.0","keywords":["mcp","confluence","atlassian","server","model-context-protocol","api"],"author":{"name":"Aionda"},"license":"MIT","_id":"@aiondadotcom/mcp-confluence-server@1.1.0","maintainers":[{"name":"stephanferraro","email":"stephan.ferraro@aionda.com"}],"homepage":"https://github.com/AiondaDotCom/mcp-confluence","bugs":{"url":"https://github.com/AiondaDotCom/mcp-confluence/issues"},"bin":{"mcp-confluence-server":"dist/index.js"},"dist":{"shasum":"2dbd7c7a8038eda9aad5302c49ba109249c9e750","tarball":"https://registry.npmjs.org/@aiondadotcom/mcp-confluence-server/-/mcp-confluence-server-1.1.0.tgz","fileCount":35,"integrity":"sha512-IrtEXa+NUX4lHjp7kfUw2yYnmfpE9mToG9m1EBjLU1BzpQxys47105Fw6ix22p0TPUxCYKAxjVB2F1frr45B5g==","signatures":[{"sig":"MEUCIQCvlEGxHL0xXwqmwep2iMKy8oqH8wolr3rH0RQSWhyDDQIgBkS1Ndl9s0vz7MZT3KAEkIA0uc7D734foMW6MfvZf58=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":90589},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"2e4f3e65e44ec49bb1eaa677c94a79884502ef58","scripts":{"dev":"ts-node --esm src/index.ts","lint":"eslint src/**/*.ts","test":"jest","build":"tsc","start":"node dist/index.js","format":"prettier --write src/**/*.ts","test:watch":"jest --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"stephanferraro","actor":{"name":"stephanferraro","type":"user","email":"stephan.ferraro@aionda.com"},"email":"stephan.ferraro@aionda.com"},"repository":{"url":"git+https://github.com/AiondaDotCom/mcp-confluence.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for Confluence API integration with Atlassian Cloud","directories":{},"_nodeVersion":"22.16.0","dependencies":{"zod":"^3.22.0","axios":"^1.6.0","fs-extra":"^11.2.0","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","eslint":"^8.57.0","ts-node":"^10.9.0","prettier":"^3.2.0","typescript":"^5.0.0","@types/jest":"^29.5.0","@types/node":"^20.0.0","@types/fs-extra":"^11.0.0","@typescript-eslint/parser":"^7.0.0","@typescript-eslint/eslint-plugin":"^7.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-confluence-server_1.1.0_1752163124624_0.18062585974174095","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@aiondadotcom/mcp-confluence-server","version":"1.1.1","keywords":["mcp","confluence","atlassian","server","model-context-protocol","api"],"author":{"name":"Aionda"},"license":"MIT","_id":"@aiondadotcom/mcp-confluence-server@1.1.1","maintainers":[{"name":"stephanferraro","email":"stephan.ferraro@aionda.com"}],"homepage":"https://github.com/AiondaDotCom/mcp-confluence","bugs":{"url":"https://github.com/AiondaDotCom/mcp-confluence/issues"},"bin":{"mcp-confluence-server":"dist/index.js"},"dist":{"shasum":"c8b511d9e49b070d56eec97cc9b30ba26a625f2b","tarball":"https://registry.npmjs.org/@aiondadotcom/mcp-confluence-server/-/mcp-confluence-server-1.1.1.tgz","fileCount":35,"integrity":"sha512-7dGHgm3scfGBRY8oZrolAue44XXr8gK/9HP6MmWlSQJQm4ICz17/7pmFhYUcesTGGrksU73+6wPd3G4kPw+48w==","signatures":[{"sig":"MEUCIEV3U0QMZYoFiq0oWLtKJOs+ANYEUUIBN6dTjhpjzaoCAiEA+vWXN9RhnecaWs0GGg8sZEcBVC8qErutgXIaO3sApe0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":91594},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"2e37f4b2e4fd6b2a876da9d7f0d70041890f2094","scripts":{"dev":"ts-node --esm src/index.ts","lint":"eslint src/**/*.ts","test":"jest","build":"tsc","start":"node dist/index.js","format":"prettier --write src/**/*.ts","test:watch":"jest --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"stephanferraro","actor":{"name":"stephanferraro","type":"user","email":"stephan.ferraro@aionda.com"},"email":"stephan.ferraro@aionda.com"},"repository":{"url":"git+https://github.com/AiondaDotCom/mcp-confluence.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for Confluence API integration with Atlassian Cloud","directories":{},"_nodeVersion":"22.16.0","dependencies":{"zod":"^3.22.0","axios":"^1.6.0","fs-extra":"^11.2.0","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","eslint":"^8.57.0","ts-node":"^10.9.0","prettier":"^3.2.0","typescript":"^5.0.0","@types/jest":"^29.5.0","@types/node":"^20.0.0","@types/fs-extra":"^11.0.0","@typescript-eslint/parser":"^7.0.0","@typescript-eslint/eslint-plugin":"^7.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-confluence-server_1.1.1_1752164557128_0.960020728088071","host":"s3://npm-registry-packages-npm-production"}},"1.1.2":{"name":"@aiondadotcom/mcp-confluence-server","version":"1.1.2","keywords":["mcp","confluence","atlassian","server","model-context-protocol","api"],"author":{"name":"Aionda"},"license":"MIT","_id":"@aiondadotcom/mcp-confluence-server@1.1.2","maintainers":[{"name":"stephanferraro","email":"stephan.ferraro@aionda.com"}],"homepage":"https://github.com/AiondaDotCom/mcp-confluence","bugs":{"url":"https://github.com/AiondaDotCom/mcp-confluence/issues"},"bin":{"mcp-confluence-server":"dist/index.js"},"dist":{"shasum":"68264372f87431083d0479070ecf2ca21e532ad2","tarball":"https://registry.npmjs.org/@aiondadotcom/mcp-confluence-server/-/mcp-confluence-server-1.1.2.tgz","fileCount":35,"integrity":"sha512-S3R5m72e/SaRF0wv5veu7pA3bAyhFrsxFTnMJOQyyS9UbO38aiQrZHrIj1nKV/T9fog4AnVx+yRL2XpU9uT48w==","signatures":[{"sig":"MEUCIEGVYYVMM7SLXWqM5HoSi4MQFIcX9rnQXTWbC0p7PBZAAiEAvIpJzgmOalDI3XrQ0qnOCLb6rLYgbQFHW3712FTMtCA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":91975},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"a1366b8adacf0490271286d43f8cfdfbb43708af","scripts":{"dev":"ts-node --esm src/index.ts","lint":"eslint src/**/*.ts","test":"jest","build":"tsc","start":"node dist/index.js","format":"prettier --write src/**/*.ts","test:watch":"jest --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"stephanferraro","actor":{"name":"stephanferraro","type":"user","email":"stephan.ferraro@aionda.com"},"email":"stephan.ferraro@aionda.com"},"repository":{"url":"git+https://github.com/AiondaDotCom/mcp-confluence.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for Confluence API integration with Atlassian Cloud","directories":{},"_nodeVersion":"22.16.0","dependencies":{"zod":"^3.22.0","axios":"^1.6.0","fs-extra":"^11.2.0","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","eslint":"^8.57.0","ts-node":"^10.9.0","prettier":"^3.2.0","typescript":"^5.0.0","@types/jest":"^29.5.0","@types/node":"^20.0.0","@types/fs-extra":"^11.0.0","@typescript-eslint/parser":"^7.0.0","@typescript-eslint/eslint-plugin":"^7.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-confluence-server_1.1.2_1752164715021_0.8528659783499069","host":"s3://npm-registry-packages-npm-production"}},"1.1.3":{"name":"@aiondadotcom/mcp-confluence-server","version":"1.1.3","keywords":["mcp","confluence","atlassian","server","model-context-protocol","api"],"author":{"name":"Aionda"},"license":"MIT","_id":"@aiondadotcom/mcp-confluence-server@1.1.3","maintainers":[{"name":"stephanferraro","email":"stephan.ferraro@aionda.com"}],"homepage":"https://github.com/AiondaDotCom/mcp-confluence","bugs":{"url":"https://github.com/AiondaDotCom/mcp-confluence/issues"},"bin":{"mcp-confluence-server":"dist/index.js"},"dist":{"shasum":"830b31b840c0978bfa6b9d1199ae46b36e6401ed","tarball":"https://registry.npmjs.org/@aiondadotcom/mcp-confluence-server/-/mcp-confluence-server-1.1.3.tgz","fileCount":35,"integrity":"sha512-dK9q19RiA4OX+T1FDvY6moSlkvfjwtZ2H/o1o0h4t0Iv3LCYh7NXN7jw5ik1bitjQxmf9O+1D9TP8qaCVJ3nhQ==","signatures":[{"sig":"MEUCIQCnMcUW85AorQQQiNNTemNmOKwmXv+LbMoJCSKMHtvetwIgI6uOkMA/NvUoHpcds8iNZyVOo498EKOqV+aaMcSSZVk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":93422},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"1a75053cc34ec4125e33eb34249b3ae49f1077c1","scripts":{"dev":"ts-node --esm src/index.ts","lint":"eslint src/**/*.ts","test":"jest","build":"tsc","start":"node dist/index.js","format":"prettier --write src/**/*.ts","test:watch":"jest --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"stephanferraro","actor":{"name":"stephanferraro","type":"user","email":"stephan.ferraro@aionda.com"},"email":"stephan.ferraro@aionda.com"},"repository":{"url":"git+https://github.com/AiondaDotCom/mcp-confluence.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for Confluence API integration with Atlassian Cloud","directories":{},"_nodeVersion":"22.16.0","dependencies":{"zod":"^3.22.0","axios":"^1.6.0","fs-extra":"^11.2.0","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","eslint":"^8.57.0","ts-node":"^10.9.0","prettier":"^3.2.0","typescript":"^5.0.0","@types/jest":"^29.5.0","@types/node":"^20.0.0","@types/fs-extra":"^11.0.0","@typescript-eslint/parser":"^7.0.0","@typescript-eslint/eslint-plugin":"^7.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-confluence-server_1.1.3_1752165956049_0.11751674200778472","host":"s3://npm-registry-packages-npm-production"}},"1.1.4":{"name":"@aiondadotcom/mcp-confluence-server","version":"1.1.4","keywords":["mcp","confluence","atlassian","server","model-context-protocol","api"],"author":{"name":"Aionda"},"license":"MIT","_id":"@aiondadotcom/mcp-confluence-server@1.1.4","maintainers":[{"name":"stephanferraro","email":"stephan.ferraro@aionda.com"}],"homepage":"https://github.com/AiondaDotCom/mcp-confluence","bugs":{"url":"https://github.com/AiondaDotCom/mcp-confluence/issues"},"bin":{"mcp-confluence-server":"dist/index.js"},"dist":{"shasum":"f46f9a57bdb76ad13e7bd4205bedcc390b2564b0","tarball":"https://registry.npmjs.org/@aiondadotcom/mcp-confluence-server/-/mcp-confluence-server-1.1.4.tgz","fileCount":35,"integrity":"sha512-MkiIlElcNaakSEw6n6kF3h+qj3+u1lED/W6AJk+iCFpHaNk61KrwaFK8fv8QltOR2nz9TPYf5cZSAKMovoFAtQ==","signatures":[{"sig":"MEUCIQDwXyLV+pOVJ7H4fMeJ44+I6RfRMJfSJvUfGfstevlSSQIgK15vfuGFrr3LitBcZ4cXJNFUSxgk6bU8OpUkM+BOG3I=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":105438},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"59a46d25023a0c5cb866cd92ce2102e4d9a66d41","scripts":{"dev":"ts-node --esm src/index.ts","lint":"eslint src/**/*.ts","test":"jest","build":"tsc","start":"node dist/index.js","format":"prettier --write src/**/*.ts","test:watch":"jest --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"stephanferraro","email":"stephan.ferraro@aionda.com"},"repository":{"url":"git+https://github.com/AiondaDotCom/mcp-confluence.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for Confluence API integration with Atlassian Cloud","directories":{},"_nodeVersion":"22.16.0","dependencies":{"zod":"^3.22.0","axios":"^1.6.0","fs-extra":"^11.2.0","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","eslint":"^8.57.0","ts-node":"^10.9.0","prettier":"^3.2.0","typescript":"^5.0.0","@types/jest":"^29.5.0","@types/node":"^20.0.0","@types/fs-extra":"^11.0.0","@typescript-eslint/parser":"^7.0.0","@typescript-eslint/eslint-plugin":"^7.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-confluence-server_1.1.4_1752236623532_0.06308795706970005","host":"s3://npm-registry-packages-npm-production"}},"1.1.5":{"name":"@aiondadotcom/mcp-confluence-server","version":"1.1.5","description":"MCP server for Confluence API integration with Atlassian Cloud","main":"dist/index.js","type":"module","bin":{"mcp-confluence-server":"dist/index.js"},"scripts":{"build":"tsc","dev":"ts-node --esm src/index.ts","start":"node dist/index.js","test":"jest","test:watch":"jest --watch","lint":"eslint src/**/*.ts","format":"prettier --write src/**/*.ts","prepublishOnly":"npm run build"},"keywords":["mcp","confluence","atlassian","server","model-context-protocol","api"],"author":{"name":"Aionda"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/AiondaDotCom/mcp-confluence.git"},"homepage":"https://github.com/AiondaDotCom/mcp-confluence","bugs":{"url":"https://github.com/AiondaDotCom/mcp-confluence/issues"},"dependencies":{"@modelcontextprotocol/sdk":"^0.5.0","axios":"^1.6.0","zod":"^3.22.0","fs-extra":"^11.2.0"},"devDependencies":{"@types/node":"^20.0.0","@types/fs-extra":"^11.0.0","typescript":"^5.0.0","ts-node":"^10.9.0","jest":"^29.7.0","@types/jest":"^29.5.0","eslint":"^8.57.0","@typescript-eslint/eslint-plugin":"^7.0.0","@typescript-eslint/parser":"^7.0.0","prettier":"^3.2.0"},"engines":{"node":">=18.0.0"},"_id":"@aiondadotcom/mcp-confluence-server@1.1.5","gitHead":"717052c2188f8df415b2e43b4255f6c30577d4d8","types":"./dist/index.d.ts","_nodeVersion":"22.16.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-LVOynJb/kHAjiK0tulDBE1YoDjpBQy9hf/Q2MM6EcdcVU3ka/2zXDdTX6ba96kn7M6QZjJAPENG45XDTkp8X4A==","shasum":"ab4d07b15dcf54f2850d21b588163adce2b260c5","tarball":"https://registry.npmjs.org/@aiondadotcom/mcp-confluence-server/-/mcp-confluence-server-1.1.5.tgz","fileCount":35,"unpackedSize":105445,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDF4C02KIR72++aM0m7D4jkFlFnBKQ+KUk2wJ0Gur11YQIhAJ02Gyo9UXBQJjVK8OcfpdcKJjKaVTu4ZpUBDHGn8EJu"}]},"_npmUser":{"name":"stephanferraro","email":"stephan.ferraro@aionda.com"},"directories":{},"maintainers":[{"name":"stephanferraro","email":"stephan.ferraro@aionda.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-confluence-server_1.1.5_1752236922308_0.5003359354937214"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-10T15:55:27.201Z","modified":"2025-07-11T12:28:42.651Z","1.0.0":"2025-07-10T15:55:27.456Z","1.1.0":"2025-07-10T15:58:44.800Z","1.1.1":"2025-07-10T16:22:37.302Z","1.1.2":"2025-07-10T16:25:15.264Z","1.1.3":"2025-07-10T16:45:56.236Z","1.1.4":"2025-07-11T12:23:43.754Z","1.1.5":"2025-07-11T12:28:42.481Z"},"bugs":{"url":"https://github.com/AiondaDotCom/mcp-confluence/issues"},"author":{"name":"Aionda"},"license":"MIT","homepage":"https://github.com/AiondaDotCom/mcp-confluence","keywords":["mcp","confluence","atlassian","server","model-context-protocol","api"],"repository":{"type":"git","url":"git+https://github.com/AiondaDotCom/mcp-confluence.git"},"description":"MCP server for Confluence API integration with Atlassian Cloud","maintainers":[{"name":"stephanferraro","email":"stephan.ferraro@aionda.com"}],"readme":"# MCP Confluence Server\n\nA TypeScript MCP (Model Context Protocol) server for integration with Atlassian Confluence.\n\n## Features\n\n- 🔧 **Automatic Configuration**: Interactive setup without manual configuration files\n- 🔐 **Secure Authentication**: API token-based authentication with automatic renewal\n- 🔍 **Complete Search Functions**: CQL-based search and full-text search\n- 📄 **Page and Space Management**: Access to Confluence content and structures\n- 🚀 **STDIO Transport**: Runs over Standard Input/Output for MCP compatibility\n- ⚡ **Rate Limiting**: Built-in protection against API overload\n- ✍️ **Write Operations**: Create and update pages with Atlassian Markup Format validation\n\n## Installation\n\n### Option 1: NPX (Recommended)\n\nThe easiest way to use the MCP Confluence server is with npx. The configuration is automatically saved in your home directory and persists between runs.\n\n#### Prerequisites\n- Install [Node.js](https://nodejs.org/en/download) (version 18 or higher)\n\n#### Setup Steps\n\n1. **Add to Claude Desktop configuration:**\n   - Open your Claude Desktop config file:\n     - **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n     - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n     - **Linux**: `~/.config/Claude/claude_desktop_config.json`\n   \n   - Add the \"confluence\" entry to your `mcpServers` configuration:\n   ```json\n   {\n     \"mcpServers\": {\n       \"confluence\": {\n         \"command\": \"npx\",\n         \"args\": [\"@aiondadotcom/mcp-confluence-server\"]\n       }\n     }\n   }\n   ```\n\n2. **Restart Claude Desktop:**\n   - Close Claude Desktop completely\n   - On Windows, also end the Claude process in Task Manager (it runs in the background)\n   - Restart Claude Desktop\n\n3. **Configure your Confluence credentials:**\n   - The MCP server will prompt you for your credentials on first use\n   - You'll need to create an API token in Confluence:\n     - Go to [Atlassian API Tokens](https://id.atlassian.com/manage-profile/security/api-tokens)\n     - Click \"Create API token\"\n     - Give it a name (e.g., \"MCP\")\n     - Copy the token\n   - The AI will ask for:\n     - Your Confluence URL (e.g., `https://your-company.atlassian.net`)\n     - Your email address\n     - Your API token\n   - The configuration will be automatically saved in `~/.mcp-confluence-config.json`\n\nThat's it! The server will now work with Claude Desktop and your configuration will persist between sessions.\n\n### Option 2: Manual Installation (Alternative)\n\nAlternative installation method for users who prefer manual setup:\n\n1. **Install the package globally:**\n   ```cmd\n   npm install -g @aiondadotcom/mcp-confluence-server\n   ```\n\n2. **Create a directory for the server:**\n   ```cmd\n   mkdir C:\\mcp-confluence\n   cd C:\\mcp-confluence\n   ```\n\n3. **Create a batch file `start-server.bat`:**\n   ```batch\n   @echo off\n   mcp-confluence-server\n   ```\n\n4. **Add to Claude Desktop configuration** (`%APPDATA%\\Claude\\claude_desktop_config.json`):\n   ```json\n   {\n     \"mcpServers\": {\n       \"confluence\": {\n         \"command\": \"C:\\\\mcp-confluence\\\\start-server.bat\",\n         \"cwd\": \"C:\\\\mcp-confluence\",\n         \"args\": [],\n         \"env\": {}\n       }\n     }\n   }\n   ```\n\n5. **Initial setup:**\n   - Start Claude Desktop\n   - Use the `setup_confluence` tool to configure your Confluence credentials\n   - The `config.json` will be saved in `C:\\mcp-confluence` and persist between runs\n\n### Option 3: Local Development\n\n```bash\ngit clone https://github.com/AiondaDotCom/mcp-confluence.git\ncd mcp-confluence\nnpm install\nnpm run build\n```\n\n## Usage\n\n### MCP Integration with NPX\n\nAdd the server to your MCP configuration using npx:\n\n```json\n{\n  \"mcpServers\": {\n    \"confluence\": {\n      \"command\": \"npx\",\n      \"args\": [\"@aiondadotcom/mcp-confluence-server\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\n### Local Development Setup\n\n1. **Copy the `mcp.json` to your MCP configuration directory**\n2. **Or add the server to your existing MCP configuration:**\n\n```json\n{\n  \"mcpServers\": {\n    \"confluence\": {\n      \"command\": \"/path/to/mcp-confluence/start-server.sh\",\n      \"cwd\": \"/path/to/mcp-confluence\",\n      \"args\": [],\n      \"env\": {}\n    }\n  }\n}\n```\n\n### Direct Start (for testing)\n\n```bash\n# NPX\nnpx @aiondadotcom/mcp-confluence-server\n\n# Local development\n./start-server.sh\n```\n\n### Configuration\n\nThe server automatically handles configuration through the `setup_confluence` tool. Configuration is saved in `~/.mcp-confluence-config.json` and persists between sessions.\n\n#### Automatic Setup\nWhen you first use the server, it will prompt you for:\n- Your Confluence URL (e.g., `https://your-company.atlassian.net`)\n- Your email address\n- Your API token\n\nThe configuration is automatically validated and saved.\n\n#### Manual Configuration (Optional)\nYou can also manually create `~/.mcp-confluence-config.json`:\n\n```json\n{\n  \"confluenceBaseUrl\": \"https://your-company.atlassian.net\",\n  \"confluenceEmail\": \"your.email@example.com\",\n  \"confluenceApiToken\": \"Your-API-Token\"\n}\n```\n\n## MCP Tools\n\n### Configuration\n\n- `setup_confluence`: Set up or update configuration\n  - `action: \"setup\"`: Initial configuration\n  - `action: \"update_token\"`: Renew token\n  - `action: \"validate\"`: Validate configuration\n\n### Search\n\n- `search_confluence`: CQL-based search\n- `search_pages`: Full-text search in pages\n- `get_recent_pages`: Recently modified pages\n\n### Content\n\n- `get_page`: Retrieve specific page\n- `get_space`: Space information\n- `list_spaces`: All available spaces\n\n### Write Operations\n\n- `create_page`: Create new Confluence pages\n  - **⚠️ IMPORTANT**: Content MUST be in Atlassian Markup Format!\n- `update_page`: Update existing Confluence pages\n  - **⚠️ IMPORTANT**: Content MUST be in Atlassian Markup Format!\n\n#### Atlassian Markup Format Examples\n\n```\nh1. Heading\n*bold text*\n_italic text_\n{info}This is an info box{info}\n{panel}This is a panel{panel}\n{code}code block{code}\n```\n\n## MCP Resources\n\n- `confluence://spaces`: All available spaces\n- `confluence://recent-pages`: Recently modified pages\n- `confluence://user`: Current user information\n\n## Configuration Storage\n\nThe configuration is automatically saved in `~/.mcp-confluence-config.json` in your home directory. This ensures the configuration persists between sessions and works with npx. No manual editing required.\n\n## Creating API Token\n\n1. Go to https://id.atlassian.com/manage-profile/security/api-tokens\n2. Click \"Create API token\"\n3. Give the token a descriptive name\n4. Copy the token (it will only be displayed once)\n5. Use the token when configuring the server\n\n## Development\n\n```bash\n# Development mode\nnpm run dev\n\n# Build\nnpm run build\n\n# Tests\nnpm test\n\n# Linting\nnpm run lint\n```\n\n## Troubleshooting\n\n### Token Issues\n\nThe server automatically detects expired or invalid tokens and prompts you to renew them.\n\n### Configuration Issues\n\nDelete `~/.mcp-confluence-config.json` and restart the server for reconfiguration.\n\n### API Errors\n\nCheck:\n- Your permissions for the Confluence instance\n- The validity of the Base URL\n- Your network connection\n\n### Markup Format Errors\n\nIf you encounter errors when creating or updating pages:\n- Ensure content is in Atlassian Markup Format, not Markdown\n- The tools will automatically detect common Markdown syntax and provide helpful error messages\n- Refer to the Atlassian Markup Format examples above\n\n## NPM Package\n\nThis server is published as `@aiondadotcom/mcp-confluence-server` on NPM.\n\n- **Package**: https://www.npmjs.com/package/@aiondadotcom/mcp-confluence-server\n- **Repository**: https://github.com/AiondaDotCom/mcp-confluence\n\n### Installation Options\n\n1. **NPX (No installation)**: `npx @aiondadotcom/mcp-confluence-server`\n2. **Global installation**: `npm install -g @aiondadotcom/mcp-confluence-server`\n3. **Local installation**: `npm install @aiondadotcom/mcp-confluence-server`\n\n## License\n\nMIT","readmeFilename":"README.md"}