wikijs-mcp
Allows managing Wiki.js 2.x pages: search, read, create, update, move, delete, browse version history, and list assets through the Wiki.js GraphQL API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@wikijs-mcp search for 'onboarding guide'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
wikijs-mcp
An MCP server for managing Wiki.js 2.x pages: search, read, create, update, move, delete, browse version history, and list assets — all through the Wiki.js GraphQL API.
Tools
Tool | Description |
| Full-text search across pages. |
| List pages with ordering, tag, and locale filters. |
| Fetch a page by id or path, including its content. |
| Browse the page hierarchy. |
| List all tags, or search tags matching a query. |
| Create a new page. |
| Partially update a page by id. |
| Move/rename a page (requires |
| Delete a page (destructive). |
| Fetch a page's version history trail. |
| Fetch the content of a specific historical version. |
| Restore a page to a prior version. |
| List asset folders and files (read-only). |
Related MCP server: Wiki.js MCP Server
Quick start (stdio)
Add the server to Claude Code with claude mcp add:
claude mcp add wikijs -e WIKIJS_URL=https://wiki.example.com -e WIKIJS_TOKEN=your-api-key-here -- npx @sondt2709/wikijs-mcpFor Claude Desktop, Cursor, or any other MCP client that reads a JSON config, add:
{
"mcpServers": {
"wikijs": {
"command": "npx",
"args": ["@sondt2709/wikijs-mcp"],
"env": {
"WIKIJS_URL": "https://wiki.example.com",
"WIKIJS_TOKEN": "your-api-key-here"
}
}
}
}Getting an API key
Log in to your Wiki.js instance as an administrator.
Go to Administration → API Access.
Toggle Enable API on.
Click New API Key, give it a name and expiration, and grant it the permissions your workflow needs (
read:pagesat minimum;write:pages,manage:pages, andmanage:systemfor creating/updating/moving/deleting pages).Copy the generated token — it's shown only once — and use it as
WIKIJS_TOKEN.
Configuration
Variable / flag | Default | Description |
| — | Base URL of your Wiki.js instance (required). |
| — | API key from Administration → API Access (required). |
|
|
|
|
| Port to listen on when |
|
| pino log level: |
CLI flags take precedence over environment variables. See .env.example for a template.
HTTP / Docker mode
Run the server as a long-lived streamable-HTTP service instead of stdio — useful for sharing one instance across multiple clients, or running behind a reverse proxy.
cp .env.example .env # set WIKIJS_URL and WIKIJS_TOKEN
docker compose upThis builds the image from the included Dockerfile and starts the server with
TRANSPORT=http on port 3000:
MCP endpoint:
http://localhost:3000/mcpHealth check:
http://localhost:3000/healthz
Point your MCP client at the /mcp endpoint instead of spawning the process directly.
MCP Inspector
To poke at the server interactively:
pnpm inspectThis builds the project and launches the MCP Inspector against the stdio transport.
To inspect an HTTP deployment instead, start the server with docker compose up (or
TRANSPORT=http pnpm dev), then run npx @modelcontextprotocol/inspector on its own and
connect the Inspector UI to http://localhost:3000/mcp using the "Streamable HTTP"
transport option.
Development
pnpm install # install dependencies
pnpm dev # run from source with --watch
pnpm lint # eslint
pnpm typecheck # tsc --noEmit
pnpm format # prettier --write
pnpm build # bundle to dist/End-to-end tests run against a real, disposable Wiki.js instance in Docker:
pnpm e2e:wiki:up # start local Wiki.js in Docker
pnpm e2e:bootstrap # headless setup: admin account + API key + e2e/.env
pnpm test:e2e # build + run the e2e suite
pnpm e2e:wiki:down # tear down the container and its dataSee e2e/setup.md for details, including a manual setup fallback if
the bootstrap script fails.
Lefthook runs eslint --fix and prettier
on staged files at pre-commit, and typecheck + build at pre-push. It's installed
automatically via the prepare script after pnpm install.
Releasing
Pushing a tag matching v* (e.g. v0.2.0) triggers .github/workflows/release.yml,
which lints, typechecks, builds, and publishes the package to npm with provenance.
The NPM_TOKEN repository secret must be set (an npm automation token with publish
access to @sondt2709/wikijs-mcp) before pushing a release tag, or the workflow will fail at the
publish step.
License
Available Tools
13 toolscreate_pageCreate pageA
Create a new Wiki.js page. Path must not start with the locale (use "guides/install", not "en/guides/install").
Inputs: path (required), title (required), content (required), tags, +5 more. Returns: page, succeeded
delete_pageDelete pageA
Permanently delete a page by id. DESTRUCTIVE and irreversible — confirm with the user before calling this.
Inputs: id (required). Returns: id, succeeded
get_pageGet pageA
Fetch one page by numeric id OR by path (+ locale, default "en"). Optionally slice its content by line range with startLine/endLine: 0-based, inclusive on both ends. Default (0..-1) returns the whole page. Negative values count from the end, Python-style (-1 = last line, -2 = second-to-last).
Inputs: id, path, locale, endLine, +1 more. Returns: page, endLine, startLine, totalLines
get_page_historyGet page historyA
List the version history trail of a page (newest first), paginated.
Inputs: id (required), offsetPage, offsetSize. Returns: total, trail
get_page_treeBrowse page treeA
Browse the page/folder hierarchy one level at a time. Omit parent for the root level; pass a folder item id as parent to descend.
Inputs: mode, locale, parent, includeAncestors. Returns: items
get_page_versionGet page versionA
Fetch the content of a specific historical version of a page. Optionally slice its content by line range with startLine/endLine: 0-based, inclusive on both ends. Default (0..-1) returns the whole version content. Negative values count from the end, Python-style (-1 = last line, -2 = second-to-last).
Inputs: pageId (required), versionId (required), endLine, startLine. Returns: endLine, version, startLine, totalLines
list_assetsList assetsA
List uploaded assets (images/files) and subfolders in an asset folder. folderId 0 is the root folder.
Inputs: kind, folderId. Returns: assets, folders
list_pagesList pagesC
List Wiki.js pages with optional ordering, tag and locale filters.
Inputs: tags, limit, locale, orderBy, +1 more. Returns: pages, total
list_tagsList tagsA
List all page tags, or search tags matching a query string.
Inputs: query. Returns: tags
move_pageMove / rename pageB
Move a page to a new path (and optionally another locale). Requires the manage:pages permission on the API key.
Inputs: id (required), destinationPath (required), destinationLocale. Returns: id, succeeded, destinationPath, destinationLocale
restore_page_versionRestore page versionA
Restore a page to a previous version from its history. The current state is preserved as a new history entry.
Inputs: pageId (required), versionId (required). Returns: pageId, succeeded, versionId
search_pagesSearch pagesA
Full-text search Wiki.js pages. Returns matching pages with id, title, path and locale. Use get_page to fetch content.
Inputs: query (required), path, locale. Returns: results, totalHits, suggestions
update_pageUpdate pageA
Update an existing page by id. Only the provided fields change. Get the id from get_page, list_pages or search_pages first.
Inputs: id (required), tags, title, content, +3 more. Returns: page, succeeded
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Each tool targets a distinct resource and action: pages vs tags vs assets, and within pages there are clear separations between listing, searching, fetching, creating, updating, moving, deleting, and history operations. Potential confusions (list_pages vs search_pages, get_page vs get_page_version) are resolved by clear descriptions.
All tool names follow a consistent verb_noun pattern with lowercase snake_case. The verbs (list, search, get, create, update, move, delete, restore) are uniformly used, and nouns clearly indicate the target resource (pages, tags, assets, page_tree, page_history).
13 tools is a well-scoped number for a Wiki.js content management server. The count covers core page lifecycle, search/navigation, history/restore, and auxiliary tag/asset listing without being excessive or too sparse.
The page lifecycle is fully covered (create, read, update, delete, move, list, search, tree, history, restore). The only notable gap is asset management, where only listing is provided (no upload/download/delete), but this is likely outside the tool's primary content-focused purpose.
Maintenance
Related MCP Connectors
MCP-native open-source Notion alternative: read & write pages, databases and kanban boards.
A MCP server built for developers enabling Git based project management with project and personal…
The official MCP Server for the Mux API
An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server for Wiki.js that enables AI agents to create, read, update, search, list, and move wiki pages via the GraphQL API. It supports surgical section updates and structured content management through named sections.6MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides a unified interface to manage Wiki.js pages, users, and groups via GraphQL API, enabling AI agents to create, read, update, and delete content and perform administrative tasks.14MIT
- AlicenseAqualityDmaintenanceMCP server for Wiki.js that exposes 29 tools for managing pages, comments, tags, assets, users, navigation, and more via HTTP/SSE with built-in mutation safety.29Creative Commons Zero v1.0 Universal
- AlicenseNot gradedqualityBmaintenanceMCP server for accessing Wiki.js through its GraphQL API, enabling page management, search, tags, and system info operations.MIT