WikiJS

You can connect your WikiJS knowledge base to an AI assistant via MCP to search, fetch, and browse wiki content programmatically. This server lets you query pages by text, retrieve specific pages by ID or path and locale, and fetch all pages, enabling rich wiki-backed interactions.

How to use

Start the WikiJS MCP Server in your environment and connect your MCP client. You can run it locally to expose an HTTP MCP endpoint or run it as a standard local process that the MCP client talks to directly. The server supports searching for pages, retrieving pages by ID, retrieving pages by path and locale, and getting all pages from the wiki. Use these capabilities from your MCP client to power AI assistants with up-to-date wiki content.

How to install

Prerequisites you need before starting:

• Node.js installed on your machine (LTS release recommended)
• Access to a WikiJS instance with an API key

Step by step commands to set up and run the WikiJS MCP Server locally:

1. Clone the repository and navigate into it

2. Install dependencies

3. Copy the environment template and fill out its contents

4. Build the project if you have make installed

5. Deploy a WikiJS instance for testing

6. Run the MCP server

WikiJS MCP Server configuration

The server can be connected in two ways: as a standard local process (stdio) or via an HTTP transport (http). Use both configurations if you want to support both methods.

HTTP MCP config (remote server)

{
  "type": "http",
  "name": "WikiJS MCP",
  "url": "<your mcp host url with port>/mcp",
  "args": []
}

STDIO MCP config (local, via npx)

{
  "type": "stdio",
  "name": "wikijs_mcp",
  "command": "npx",
  "args": ["wikijs-mcp"],
  "env": [
    {"name": "WIKIJS_URL", "value": "<your wikijs url>"},
    {"name": "WIKIJS_API_KEY", "value": "<your wikijs api key>"}
  ]
}

Environment variables

Required values you must provide when configuring the server:

Server and environment overview

• WIKIJS_URL: URL of your WikiJS instance (required)\n- WIKIJS_API_KEY: WikiJS API key with appropriate permissions (required)\n- TRANSPORT_METHOD, TRANSPORT_OPTIONS_*: Optional transport settings for the HTTP streamable transport if you use that mode

Usage patterns

• Use search to find pages by query, then retrieve the page by ID or path to display content in your assistant.

• Retrieve all pages to build a local index for quick access.

Available tools

searchPages

Search wiki pages by a query string and return matching results.

getPageById

Retrieve a single wiki page by its unique ID.

getPageByPathLocale

Retrieve a wiki page by its path and locale.

getAllPages

Fetch all pages from the wiki to enable bulk operations or indexing.