Wiki.js MCP Server
MCP server for Wiki.js: create, read, list, search, update, move and delete pages through the GraphQL API. Node.js, stdio, 7 tools.
Deprecated for Claude Code: Manually installing this server (clone, build, configure) is deprecated for Claude Code. Its successor is the Python-based wikijs-plugin. For other MCP clients this server remains available and maintained.
Wiki.js MCP Server
The Wiki.js MCP Server connects an MCP client to your Wiki.js instance. Through the Wiki.js GraphQL API the client can create, retrieve, list, search, update, move and delete pages.
This page describes the standalone Node.js server (repository
wikijs-mcp-server). For Claude Code the wikijs-plugin replaces it with a Python MCP server and marketplace installation. The seven tools of this server carry the same names there; the plugin additionally offers tools for change history and verified markers (10 tools in total) as well as skills for verified documentation.
At a glance
- 7 tools with the prefix
wikijs_: create, get, list, search, update, delete, move - Transport: stdio, authentication with a bearer token against the GraphQL endpoint of your Wiki.js instance
- All input is validated with Zod (path, locale, tag and size limits)
- Configuration through two environment variables:
WIKIJS_API_URLandWIKIJS_API_TOKEN - No telemetry: the server talks only to the configured Wiki.js URL
Requirements
| Requirement | Details |
|---|---|
| Node.js | 18 or newer (engines in package.json; CI tests 18, 20 and 22) |
| npm | to install dependencies and to build |
| Wiki.js | instance with a reachable GraphQL API (endpoint ends in /graphql) |
| API key | Wiki.js API key with the permissions read:pages, write:pages, manage:pages (per .env.example) |
| MCP client | any client that can launch stdio servers |
Documentation
| Page | Content |
|---|---|
| Installation | Clone, build, register the client, update, uninstall |
| Configuration | Environment variables, .env lookup order, creating the API key, fixed limits |
| Tools reference | All 7 tools with parameters, return values and caveats |
| Usage and examples | Typical workflows and example calls |
| Security | Token handling, logging, permissions, destructive operations |
| Technical details | Structure, GraphQL operations, error handling, development |
| Troubleshooting | Messages and their causes |
Quick start
git clone https://github.com/markus-michalski/wikijs-mcp-server.git
cd wikijs-mcp-server
npm install
npm run build
cp .env.example .env
Enter the URL and token in .env and have your MCP client launch node /path/to/wikijs-mcp-server/dist/index.js. It matters where the server looks for the .env: see Configuration.
License
MIT, see LICENSE.