wikijs-mcp

MCP server for accessing Wiki.js through the GraphQL API, built with FastMCP (Python).

Exposed Tools

The mail domain requires the manage:system permission. Unlike the other domains, both mail tools can only be used with a Wiki.js API key belonging to the Administrators group (the manage:system permission). wikijs_mail_update_config is also REPLACE-ALL in nature — a single call overwrites the entire mail configuration of the instance, not just the fields mentioned.

The storage domain also requires the manage:system permission. The four storage tools can only be used with an API key belonging to the Administrators group. Force Sync (the button in Admin → Storage) is run with wikijs_storage_action_execute(target_key="git", handler="sync"). wikijs_storage_target_list masks configuration values that are credentials (basicPassword, sshPrivateKeyContent) as *** — the original values cannot be read via MCP. Handlers are not whitelisted: use the actions from wikijs_storage_target_list to find available handlers, and note that some of them are destructive (purge deletes the local Git repo, importAll overwrites the wiki content from the local repo).

wikijs_storage_target_update(target_key, is_enabled, mode, sync_interval, config) changes the configuration of one target with partial update semantics: arguments that are not filled in mean "don't change", and config is merged per key. The underlying Wiki.js mutation (storage.updateTargets) is actually REPLACE-ALL, so the tool performs its own read-modify-write so that fields not mentioned are not deleted. config keys that do not yet exist on the target are rejected (ValueError), as is the value "***" — that is the redaction sentinel of wikijs_storage_target_list, not the real credential.

Related MCP server: mcp-wikijs-mv

Configuration

Copy .env.example to .env and fill in the appropriate values:

cp .env.example .env

Required Variables

How to Use

stdio (Claude Desktop / VS Code)

{
  "mcpServers": {
    "wikijs": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/andhit-r/wikijs-mcp", "wikijs-mcp"],
      "env": {
        "WIKIJS_URL": "https://wiki.example.com",
        "WIKIJS_API_KEY": "your-api-key"
      }
    }
  }
}

HTTP + API Key (Claude Code / VS Code remote)

docker run -p 8000:8000 \
  -e WIKIJS_URL=https://wiki.example.com \
  -e WIKIJS_API_KEY=your-wikijs-api-key \
  -e MCP_API_KEY=your-mcp-api-key \
  ghcr.io/andhit-r/wikijs-mcp:latest

HTTP + Authentik OAuth (Claude Web)

Fill in all AUTHENTIK_* and MCP_BASE_URL variables in .env, then:

docker run -p 8000:8000 --env-file .env ghcr.io/andhit-r/wikijs-mcp:latest

License

MIT