WikiJS MCP Server

A Model Context Protocol (MCP) server for integrating with Wiki.js instances, enabling Claude to read and update documentation.

Features

Search Pages: Find pages by title or content
Read Pages: Get full page content by path or ID
List Pages: Browse all pages with pagination
Page Tree: View wiki structure as a tree
Create Pages: Add new documentation pages
Update Pages: Modify existing page content
Authentication: Secure API key-based access

Installation

Clone this repository:

git clone <repository-url>
cd wikijs-mcp

Install dependencies:

pip install -e .

Configure environment:

cp .env.example .env
# Edit .env with your Wiki.js details

Configuration

Create a .env file with your Wiki.js configuration:

WIKIJS_URL=https://your-wiki.example.com
WIKIJS_API_KEY=your_api_key_here
WIKIJS_GRAPHQL_ENDPOINT=/graphql  # Optional, defaults to /graphql
DEBUG=false  # Optional, enables debug logging

Getting Wiki.js API Key

Log into your Wiki.js admin panel
Go to Administration → API Access
Enable the API if not already enabled
Click New API Key
Set appropriate permissions for your use case
Add the key to your .env file

Usage

🐳 Docker (Recommended)

Quick Start with Docker

Create your .env file in the config/ directory with your WikiJS settings
Start the server:

docker compose up -d wikijs-mcp-server

View logs:

docker compose logs -f wikijs-mcp-server

Docker Management Commands

# Start server in background
docker compose up -d wikijs-mcp-server

# Access interactive shell
docker-compose run --rm wikijs-mcp-server bash

# Stop server
docker compose down

Docker with Claude Code

Add to your Claude Code MCP configuration:

{
  "mcpServers": {
    "wikijs": {
      "command": "docker",
      "args": ["exec", "-i", "wikijs-mcp-server", "python3", "-m", "wikijs_mcp.server"],
      "env": {
        "DOCKER_CONTAINER": "wikijs-mcp-server"
      }
    }
  }
}

Standalone Server

Run the server directly:

python -m wikijs_mcp.server

With Claude Code (Native)

Add to your Claude Code MCP configuration:

{
  "mcpServers": {
    "wikijs": {
      "command": "python3",
      "args": ["-m", "wikijs_mcp.server"],
      "cwd": "/path/to/wikijs-mcp"
    }
  }
}

Available Tools

`wiki_search`

Search for pages by title or content.

Parameters: query (string), limit (optional integer)

`wiki_get_page`

Get a specific page by path or ID.

Parameters: path (string) OR id (integer)

`wiki_list_pages`

List all pages with pagination.

Parameters: limit (optional integer), offset (optional integer)

`wiki_get_tree`

Get wiki page tree structure.

Parameters: parent_path (optional string)

`wiki_create_page`

Create a new wiki page.

Parameters: path (string), title (string), content (string), description (optional), tags (optional array)

`wiki_update_page`

Update an existing wiki page.

Parameters: id (integer), content (string), title (optional), description (optional), tags (optional array)

Example Usage with Claude

# Search for documentation
"Search for pages about authentication"

# Read a specific page
"Get the content of the page at path 'docs/api/authentication'"

# Update documentation
"Update page ID 123 with improved authentication examples"

# Create new documentation
"Create a new page at 'docs/troubleshooting/common-issues' with troubleshooting guide"

Development

Setup Development Environment

Install development dependencies:

pip install -e ".[dev]"

Testing

The project has comprehensive test coverage with pytest:

# Run all tests
pytest

# Run with coverage report
pytest --cov=wikijs_mcp --cov-report=html

# Run specific test categories
pytest -m unit          # Unit tests only
pytest -m integration   # Integration tests only

# Run tests in parallel (faster)
pytest -n auto

Test Categories

Unit tests (-m unit): Fast, isolated component tests
Integration tests (-m integration): Full MCP server functionality tests
Network tests (-m network): Tests requiring network access (skipped by default)

Code Quality

Format code:

black wikijs_mcp/ tests/

Type checking:

mypy wikijs_mcp/

Security scanning:

bandit -r wikijs_mcp/
safety check

Docker Testing

Test the Docker build:

docker compose build
docker-compose run --rm wikijs-mcp-server bash

CI/CD

The project uses GitHub Actions for:

✅ Multi-Python testing (3.8-3.12)
✅ Code quality checks (black, mypy)
✅ Security scanning (bandit, safety)
✅ Docker build testing
✅ Coverage reporting (Codecov)

Requirements

Python 3.8+
Wiki.js 2.2+ (for API access)
Valid Wiki.js API key with appropriate permissions

License

MIT License

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that enables Claude to read and update documentation in Wiki.js instances through capabilities like searching, reading, creating, and updating wiki pages.

Related MCP Servers

MCP Expert Server
crazyrabbitLTC
-
security
F
license
-
quality
A Model Context Protocol server utilizing Claude AI for generating intelligent queries and offering documentation assistance based on API documentation analysis.
Last updated -
3
2
TypeScript
Warpcast MCP Server
zhangzhongnan928
-
security
A
license
-
quality
A Model Context Protocol server that allows Claude to interact with Warpcast accounts, enabling actions like posting casts, reading content, searching by keywords, and managing channel interactions through natural language.
Last updated -
2
Python
MIT License
ConnectWise Manage MCP Server
ethangillani
-
security
A
license
-
quality
A Model Context Protocol server that enables Claude to interact with the ConnectWise Manage API to perform operations like retrieving, creating, updating, and deleting tickets, companies, contacts, and other entities.
Last updated -
JavaScript
MIT License
MCP Deep Web Research Server
PedroDnT
-
security
A
license
-
quality
A Model Context Protocol server that enables Claude to perform advanced web research with intelligent search queuing, enhanced content extraction, and deep research capabilities.
Last updated -
53
TypeScript
MIT License

View all related MCP servers

WikiJS MCP Server