wikijs-mcp-server

markus-michalski/wikijs-mcp-server

3.2

If you are the rightful owner of wikijs-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Wiki.js MCP Server is a Model Context Protocol server designed to interact with the Wiki.js GraphQL API, enabling seamless management of wiki pages through a tool-based interface.

Tools
7
Resources
0
Prompts
0

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

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

ToolDescriptionAnnotations
wikijs_create_pageCreate new wiki pages with Markdown or HTMLdestructiveHint: false
wikijs_update_pageUpdate existing pages (content, title, tags)idempotentHint: true
wikijs_get_pageRetrieve full page content and metadatareadOnlyHint: true
wikijs_list_pagesList pages with pagination and filteringreadOnlyHint: true
wikijs_search_pagesFull-text search across wiki pagesreadOnlyHint: true
wikijs_delete_pagePermanently delete pagesdestructiveHint: true
wikijs_move_pageMove pages to new pathsdestructiveHint: false

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 for details

Author

Markus Michalski

Links