wiki-js-mcp
Provides tools for interacting with Wiki.js via its GraphQL API, enabling AI agents to create, read, update, search, list, and move wiki pages, including surgical updates to named sections using HTML comment markers.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@wiki-js-mcpsearch for pages about API documentation"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
wiki-js-mcp
An MCP server for Wiki.js — lets AI agents create, read, update, search, list, and move wiki pages via the Wiki.js GraphQL API.
Tools
Tool | Description |
| Read a page's content and metadata by path |
| Create a new page with markdown content |
| Update content, metadata, or patch a named section |
| Full-text search — returns title, path, description, tags |
| List pages with an optional path-prefix filter |
| Rename or restructure a page path |
All tools return {"success": bool, "error": str | null, ...} and never raise — the calling agent decides how to handle failures.
Section patching
wiki_update_page supports surgical updates to named sections without touching the rest of the page. Fence any block in your wiki content with HTML comments:
<!-- OSIA:AUTO:watchlist -->
Content managed by the AI agent goes here.
<!-- /OSIA:AUTO:watchlist -->Then call:
wiki_update_page(
path="desks/geopolitical-and-security",
section="watchlist",
section_content="- Benjamin Netanyahu (🔴 Critical)\n- ...",
)The markers and surrounding content are left untouched.
Related MCP server: WikiJS MCP Server
Requirements
Python 3.11+
uv (recommended) or pip
A running Wiki.js 2.x instance with a valid API key
Installation
git clone https://github.com/osianet/wiki-js-mcp.git
cd wiki-js-mcp
uv syncCopy .env.example to .env and fill in your values:
cp .env.example .envWIKIJS_URL=http://localhost:3000/graphql
WIKIJS_API_KEY=your-api-key-hereGenerate an API key at https://your-wiki/a/api-keys in the Wiki.js admin panel.
Usage
Standalone (stdio)
uv run wiki-mcpWith Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"wiki-js": {
"command": "uv",
"args": ["run", "--directory", "/path/to/wiki-js-mcp", "wiki-mcp"],
"env": {
"WIKIJS_URL": "http://localhost:3000/graphql",
"WIKIJS_API_KEY": "your-api-key-here"
}
}
}
}With Claude Code
Add to your project's .claude/settings.json or ~/.claude/settings.json:
{
"mcpServers": {
"wiki-js": {
"command": "uv",
"args": ["run", "--directory", "/path/to/wiki-js-mcp", "wiki-mcp"]
}
}
}Development
uv sync --extra dev
# Lint
uv run ruff check wiki_mcp.py
# Format
uv run ruff format wiki_mcp.py
# Type check
uv run pyright wiki_mcp.py
# Tests
uv run pytestLicense
MIT — see LICENSE.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseAqualityCmaintenanceAn MCP server that enables AI agents to interact with Wiki.js as a knowledge base through a comprehensive set of 29 tools for content retrieval and management. It supports full-text search, page versioning, and asset browsing with optional write operations secured by safety gates.Last updated29303MIT
- Alicense-qualityDmaintenanceAn MCP server that enables full management of WikiJS instances, supporting operations like page creation, searching, and updating. It also provides tools for knowledge graph exploration, content summarization, and retrieval of wiki statistics.Last updated19MIT
- Alicense-qualityDmaintenanceAn MCP server that provides a unified interface to manage Wiki.js pages, users, and groups via GraphQL API, enabling AI agents to create, read, update, and delete content and perform administrative tasks.Last updated5012MIT
- Alicense-qualityDmaintenanceMCP server for Wiki.js integration, enabling AI assistants to create, read, update, delete, search, and move wiki pages via natural language.Last updated1MIT
Related MCP Connectors
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
MCP server for AgentDocs (agentdocs.eu): read, search, write, comment on & share Markdown docs.
Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/osianet/wiki-js-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server