Wiki.js Plugin: Configuration

Configure the Wiki.js plugin: environment variables WIKIJS_API_URL and WIKIJS_API_TOKEN, .env loading order, creating an API token, local files under ~/.wikijs-plugin.

Deutsche Version

Back to overview

Wiki.js Plugin: Configuration

This documentation always describes the latest published version.

The plugin has exactly two settings. There are no further configuration options.

Environment variables

Variable	Required	Description
`WIKIJS_API_URL`	Yes	GraphQL endpoint of the Wiki.js instance, ends with `/graphql` (e.g. `https://wiki.example.com/graphql`)
`WIKIJS_API_TOKEN`	Yes	API token from the Wiki.js admin area, sent as a bearer token

There are no default values. If one of the two variables is missing, the server aborts with an error message (see Troubleshooting).

WIKIJS_API_URL=https://your-wiki-instance.example/graphql
WIKIJS_API_TOKEN=your-api-token-here

Where the values are loaded from

If the file ~/.wikijs-plugin/.env exists, it is loaded. This path is outside the plugin directory and survives plugin updates.
If it does not exist, the server searches for another .env through python-dotenv (meant for local development).
Environment variables already set in the process are not overwritten by a .env file.

The credentials are checked when the MCP server starts and cached for the lifetime of the process on the first tool call.

Changes to ~/.wikijs-plugin/.env only take effect after restarting Claude Code.

Creating the API token in Wiki.js

Open API Access in the Wiki.js admin area
Generate a new key, e.g. named wikijs-plugin
Select the permissions read:pages, write:pages and manage:pages
Enter the token in the .env file

Permission	Used for
`read:pages`	Reading, listing and searching pages
`write:pages`	Creating and updating pages
`manage:pages`	Deleting and moving pages

If you only need reading and writing, read:pages and write:pages are enough. Deleting and moving are then not permitted on the Wiki.js side.

Local files

Path	Content	Created by
`~/.wikijs-plugin/.env`	Credentials	Setup skill (template), you enter the values
`~/.wikijs-plugin/venv/`	Python environment of the MCP server	Setup skill
`~/.wikijs-plugin/wikijs-plugin.db`	SQLite database with change history and verified markers	MCP server on first access
`~/.wikijs-plugin/glossary.local.md`	Your own glossary entries for `translation-check` (optional)	You, or the skill on request

Limits that are not configurable

These values are fixed in the code:

Limit	Value
Time limit per API request	30 seconds
Maximum page content length on write	500,000 characters
Page content on read	truncated from 100,000 characters
Pages per `wikijs_list_pages` call	1 to 200, default 50

Details on all tools are on the Tools page.