This MCP server provides a unified interface to interact with Wiki.js via GraphQL API. It exposes a set of pages, user, and group management tools that allow you to list, search, create, update, publish, and delete pages, as well as manage users and user groups. The server supports both HTTP transport (for web integrations) and STDIO transport (for direct editor integrations via Cursor or similar tools). To start using it, run the Node.js-based STDIN server or HTTP server as described in the installation guide, and point your MCP clients to the appropriate endpoint or STDIN stream. The tools exposed include list_pages, get_page, list_all_pages, search_pages, create_page, update_page, delete_page, force_delete_page, publish_page, get_page_status, list_users, search_users, create_user, update_user, and list_user_groups, among others.

Prerequisites:

• Node.js >= 18.0.0
• Git
• Internet access to install dependencies

Setup steps:

1. Clone the repository: git clone https://github.com/heAdz0r/wikijs-mcp-server.git cd wikijs-mcp-server

2. Install dependencies and build: npm install npm run setup

3. Configure Wiki.js access:

   • Edit the .env file created by setup and set WIKIJS_BASE_URL to your Wiki.js GraphQL endpoint (without /graphql) and WIKIJS_TOKEN to a valid API token.

4. Start the server:

   HTTP server (recommended) or STDIO mode using the provided npm scripts

   npm start

   or for STDIO mode if configured

   npm run server:stdio

5. Verify the server is running:

   • Access the health endpoint if using HTTP: GET http://localhost:3200/health
   • Use the MCP client to call methods like list_pages or get_page.

Environment variables:

• WIKIJS_BASE_URL: Base URL of your Wiki.js instance (without /graphql)
• WIKIJS_TOKEN: Wiki.js API token with the necessary permissions

MCP usage tips:

• The example config uses a Node.js STDIN server script (lib/mcp_wikijs_stdin.js). If you prefer HTTP, ensure you start the HTTP MCP server (port 3200 by default) and point clients to http://localhost:3200/mcp.
• For Cursor integration, ensure the .cursor/mcp.json configuration references the correct transport (http) and URLs, and that the WIKIJS_TOKEN is valid.
• Unpublished page operations (list_all_pages, search_unpublished_pages, publish_page, force_delete_page) require appropriate permissions on Wiki.js and may be restricted by token scopes.
• If you encounter token or CORS issues, validate the base URL, token, and that Wiki.js API is accessible from the MCP server host.
• The available tools can be listed via the /tools HTTP endpoint or the equivalent in STDIO mode; consult the repository’s API.ts and tools.ts for exact method names.