MCP WikiJS

July 8, 2026 ยท View on GitHub

An MCP (Model Context Protocol) server for WikiJS that allows AI models to interact with wiki content.

Features

  • An MCP server exposing WikiJS as tools (stdio transport; no MCP resources/prompts yet)
  • Built with TypeScript for type safety and modern JavaScript features
  • Simple to use - can be started with a single npx command
  • Provides AI models with access to WikiJS content through MCP tools:
    • Search documents
    • Read document content
    • Create new documents
    • Update existing documents
    • Delete documents
  • Docker-ready for easy development setup

Installation

Using npx (once published to npm)

No local clone or build required. Add this to your MCP client config (e.g. Claude Desktop/Code):

{
  "mcpServers": {
    "wikijs": {
      "command": "npx",
      "args": ["-y", "@im-neko/mcp-wikijs"],
      "env": {
        "WIKIJS_URL": "https://example.com",
        "WIKIJS_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

From source (current development install)

git clone https://github.com/Im-neko/mcp-wikijs.git
cd mcp-wikijs
npm install
npm run build

{
  "mcpServers": {
    "wikijs": {
      "command": "node",
      "args": ["path/to/mcp-wikijs/dist/index.js"],
      "env": {
        "WIKIJS_URL": "https://example.com",
        "WIKIJS_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Docker Development Environment

For development purposes, this project includes a Docker Compose setup that starts:

  • A PostgreSQL database
  • A WikiJS instance
  • The MCP-WikiJS server with hot-reload

To start the development environment:

docker-compose up

For detailed instructions, see the Docker guide.

Available Tools

  • search - Search for wiki pages by query
  • read - Read a wiki page by ID or path
  • create - Create a new wiki page
  • update - Update an existing wiki page
  • delete - Delete a wiki page by ID

Examples

See the examples directory for detailed usage examples, including:

  • Integrating with chat applications
  • Document search and retrieval
  • Content creation and management

Configuration

WikiJS Configuration

  • WIKIJS_URL: URL of your WikiJS instance
  • WIKIJS_TOKEN: API token for authentication with WikiJS

Logging

  • LOG_LEVEL: Logging level (debug, info, warn, error; default: info)

The server communicates with its MCP client over stdio only; there is no HTTP transport or port to configure.

Development

See Installation > From source to build locally. To inspect the server interactively:

npx @modelcontextprotocol/inspector node dist/index.js

Docker Development

See the Docker guide for instructions on setting up a complete development environment with Docker.

Project Documentation

Architecture

This project follows a modular architecture with clear separation of concerns:

  • Configuration management: Environment variables and settings
  • WikiJS client: Handles communication with WikiJS GraphQL API
  • MCP server: Implements the Model Context Protocol
  • Tools: Implements specific operations (search, read, update, etc.)

License

MIT