wikijs-mcp

MCP (Model Context Protocol) server for Wiki.js that exposes page management through Wiki.js's GraphQL API.

Tools

Related MCP server: wikijs-mcp

Prerequisites

1. A running Wiki.js instance (v2.x)

2. An API key — create one at Administration > API Access in your Wiki.js admin panel

3. The API key needs appropriate permission scopes for pages (read/write/manage)

Setup

cp .env.example .env
# Edit .env with your Wiki.js URL and API key

Option A: Local (Node.js >=18)

npm install
npm run build
npm start

For development:

npm run dev

Option B: Docker

docker compose build
docker compose up -d

Claude Code Integration

Add to your Claude Code MCP config (.claude/settings.json or project settings):

{
  "mcpServers": {
    "wikijs": {
      "command": "node",
      "args": ["d:/projects/ai/wikijs-mcp/dist/index.js"],
      "env": {
        "WIKIJS_URL": "https://wiki.example.com",
        "WIKIJS_API_KEY": "your-api-key"
      }
    }
  }
}

Or using npx tsx for development without building:

{
  "mcpServers": {
    "wikijs": {
      "command": "npx",
      "args": ["tsx", "d:/projects/ai/wikijs-mcp/src/index.ts"],
      "env": {
        "WIKIJS_URL": "https://wiki.example.com",
        "WIKIJS_API_KEY": "your-api-key"
      }
    }
  }
}

Wiki.js API Reference

This server uses the Wiki.js GraphQL API. You can explore the full schema interactively at https://your-wiki.example.com/graphql when logged in as admin.