Wiki.js MCP Server

Model Context Protocol Server for Wiki.js integration in Claude Code - Create and manage wiki pages directly from your AI assistant.

v2.0.0 - Major Refactoring

This version includes a complete rewrite following MCP Best Practices:

• TypeScript - Full type safety with strict mode

• Modern SDK - Uses MCP SDK v1.24+ with McpServer.tool() API

• Zod Validation - Runtime input validation for all tools

• Service-Prefixed Tools - All tools use wikijs_ prefix for namespace clarity

• Tool Annotations - Proper readOnlyHint, destructiveHint, etc.

• Pagination Support - List operations return has_more, next_offset, total_count

• Character Limits - Large content is truncated with clear notices

Related MCP server: mediawiki-mcp-server

Documentation

Complete Documentation & FAQ

The comprehensive guide includes:

• Installation instructions

• Configuration examples

• All 7 MCP tools with parameters

• GraphQL API integration details

• Troubleshooting guide

Quick Start

# 1. Clone repository
git clone https://github.com/markus-michalski/wikijs-mcp-server.git ~/.claude/mcp-servers/wikijs

# 2. Install dependencies
cd ~/.claude/mcp-servers/wikijs
npm install

# 3. Build TypeScript
npm run build

# 4. Configure environment
cp .env.example .env
# Edit .env with your Wiki.js API credentials

# 5. Add to Claude Code config and restart

Requirements

• Node.js 18+

• Wiki.js instance (v2.x or v3.x)

• Wiki.js API Token with page management permissions

Available Tools

Development

# Development with hot-reload
npm run dev

# Build for production
npm run build

# Type checking
npm run typecheck

Project Structure

wikijs-mcp-server/
├── src/
│   ├── index.ts           # Main server entry point
│   ├── constants.ts       # Shared constants (CHARACTER_LIMIT, etc.)
│   ├── types.ts           # TypeScript type definitions
│   ├── schemas/           # Zod validation schemas
│   ├── services/          # API client and error handling
│   └── tools/             # Tool implementations
├── dist/                  # Compiled JavaScript
├── evaluation.xml         # MCP evaluation test questions
└── package.json

License

MIT License - See LICENSE for details

Author

Markus Michalski

• Website: markus-michalski.net

• GitHub: @markus-michalski

Links

• Full Documentation (English)

• Vollstaendige Dokumentation (Deutsch)

• Changelog