mcp-wikijs

MCP server for creating, reading, updating, deleting, and searching Wiki.js pages through the Wiki.js GraphQL API.

Configuration

Set secrets through environment variables. Do not commit real tokens, passwords, cookies, or .env files.

Required:

• WIKIJS_BASE_URL: Wiki.js base URL, for example http://100.123.55.97:30081/.
• WIKIJS_API_TOKEN: preferred authentication method.

Password fallback, only when an API token is not available:

• WIKIJS_USERNAME: Wiki.js username or email.
• WIKIJS_PASSWORD: Wiki.js password.
• WIKIJS_AUTH_STRATEGY: optional, defaults to local.

Optional:

• WIKIJS_GRAPHQL_URL: override the GraphQL endpoint. Defaults to <WIKIJS_BASE_URL>/graphql.
• WIKIJS_TIMEOUT_MS: request timeout in milliseconds. Defaults to 15000.

Run

npm install
WIKIJS_BASE_URL="http://100.123.55.97:30081/" WIKIJS_API_TOKEN="..." npm start

MCP client command example:

{
  "mcpServers": {
    "wikijs": {
      "command": "node",
      "args": ["/home/set/mcp-wikijs/src/index.js"],
      "env": {
        "WIKIJS_BASE_URL": "http://100.123.55.97:30081/",
        "WIKIJS_API_TOKEN": "..."
      }
    }
  }
}

Tools

• wikijs_search_pages: search by query or list pages by locale/tags/path filter.
• wikijs_get_page: read a page by id or by path plus locale.
• wikijs_create_page: create a page with path, title, content, locale, and editor.
• wikijs_update_page: update a page by id or by path plus locale.
• wikijs_delete_page: delete a page by id or by path plus locale.

Examples

Search pages:

{
  "query": "runbook",
  "locale": "en"
}

Read a page:

{
  "path": "operations/runbook",
  "locale": "en"
}

Create a page:

{
  "path": "operations/runbook",
  "title": "Operations Runbook",
  "content": "# Operations Runbook\n\nInitial content.",
  "locale": "en",
  "editor": "markdown",
  "description": "Operational procedures",
  "isPublished": true,
  "isPrivate": false,
  "tags": ["operations"]
}

Update a page:

{
  "path": "operations/runbook",
  "locale": "en",
  "content": "# Operations Runbook\n\nUpdated content.",
  "tags": ["operations", "runbook"]
}

Delete a page:

{
  "path": "operations/runbook",
  "locale": "en"
}

Delete operations resolve the target first and fail without deleting when the target cannot be resolved.