Wiki.js Plugin: Installation
Install the Wiki.js plugin: marketplace installation, setup skill (venv under ~/.wikijs-plugin), requirements, update and uninstall.
Wiki.js Plugin: Installation
This documentation always describes the latest published version.
Requirements
| Requirement | Note |
|---|---|
| Claude Code | Installed via the plugin marketplace mechanism |
| Python 3.11 or newer | Needed by the setup skill for the venv. On Windows the py launcher resolves this reliably even when python and python3 point at the Microsoft Store alias |
| Wiki.js | With a reachable GraphQL API. The plugin uses the pages queries of the Wiki.js 2.x API |
| Wiki.js API token | Permissions according to the .env template: read:pages, write:pages, manage:pages |
Installation
Step 1: Register the marketplace and install the plugin
claude plugin marketplace add markus-michalski/wikijs-plugin
claude plugin install wikijs-plugin@wikijs-plugin
A plain git clone is not enough to run the plugin: the MCP server starts through the wrapper bin/run-server, which uses the Python interpreter from ~/.wikijs-plugin/venv/, and only the setup skill creates that venv.
Step 2: Run the setup skill
/wikijs-plugin:setup
The skill works through these steps:
- Find a working Python interpreter (
python3, thenpython, thenpy -3, then known Windows install paths) - Create the folder
~/.wikijs-pluginif it is missing - Create the venv
~/.wikijs-plugin/venvif it is missing - Always sync the dependencies from
requirements.txt, even if the venv already exists - Copy the
.envtemplate to~/.wikijs-plugin/.env, but only if that file does not exist yet - Check that
mcp,httpxanddotenvcan be imported (no valid Wiki.js login needed) - Print a report (data directory, venv, dependencies,
.env, MCP)
Step 3: Enter credentials and restart
Enter the values WIKIJS_API_URL and WIKIJS_API_TOKEN in ~/.wikijs-plugin/.env (details on the Configuration page) and restart Claude Code so the MCP server gets loaded.
Afterwards, check with
/mcpthat the serverwikijs-mcpis connected.
Switching from wikijs-mcp-server (Node.js)
The variable names WIKIJS_API_URL and WIKIJS_API_TOKEN are the same as in the standalone wikijs-mcp-server. You can copy the values into the new ~/.wikijs-plugin/.env and need no new token. Then remove the old manual MCP registration, otherwise the tools show up twice.
Update
You update the plugin through the Claude Code plugin management. Credentials and history live outside the plugin directory in ~/.wikijs-plugin and survive the update. After an update, run /wikijs-plugin:setup again: the skill always re-syncs the dependencies so new packages are not missed, and it does not overwrite an existing .env. Restart Claude Code afterwards.
Uninstall
You remove the plugin through the Claude Code plugin management. The folder ~/.wikijs-plugin (venv, .env, database wikijs-plugin.db, optional glossary.local.md) is not deleted automatically. If you want to get rid of the token and the local history, delete the folder yourself.
Deleting the folder also removes the verified markers (see Technical). Pages count as unverified again afterwards.