Skip to content
MCP server

Openzim MCP

Offline MCP access to ZIM archives such as Wikipedia, Wiktionary and Stack Exchange

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
3.4.0
Listing updated
today

Similar MCP servers

About Openzim MCP

Openzim MCP is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

It reads Kiwix-style ZIM files from a local directory, so a model can consult Wikipedia or a Stack Exchange dump without internet access. The server does nothing until you point it at an archive; the README suggests a 13.6 MB climate-change extract of English Wikipedia for a first try, with full archives running from hundreds of MB to tens of GB.

Two modes exist. Simple mode exposes a single natural-language tool, zim_query, aimed at small models, and advanced mode exposes eight tools for search, section retrieval, browsing, metadata, links and health. Archive-type presets tune retrieval, so Stack Exchange dumps render as clean Q&A. Inbound link discovery needs a pre-built link-graph sidecar file.

Beyond stdio, a Streamable HTTP mode adds bearer auth, CORS and health endpoints, and a multi-arch Docker image is published. Entries are also exposed as MCP resources with change notifications.

Install

Run in a terminal

claude mcp add openzim-mcp -- uvx openzim-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "openzim-mcp": {
      "command": "uvx",
      "args": [
        "openzim-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "openzim-mcp": {
      "command": "uvx",
      "args": [
        "openzim-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "openzim-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "openzim-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "openzim-mcp": {
      "command": "uvx",
      "args": [
        "openzim-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "openzim-mcp": {
      "command": "uvx",
      "args": [
        "openzim-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • OPENZIM_MCP_TOOL_MODETool surface: 'advanced' (the default here) registers all 8 tools (zim_query, zim_search, zim_get, zim_get_section, zim_browse, zim_metadata, zim_links, zim_health); 'simple' registers only the zim_query natural-language entry point.

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

zim_query
Natural-language entry point that dispatches to the right operation.
zim_search
Searches archives.
zim_get
Gets an entry.
zim_get_section
Gets a section of an entry.
zim_browse
Browses archive contents.
zim_metadata
Reports archive metadata.
zim_links
Returns outbound or inbound links.
zim_health
Validates an archive.

What it does

Single-tool simple mode
zim_query handles natural-language requests.
Eight advanced tools
Search, get, section, browse, metadata, links and health.
Archive presets
Auto-tunes retrieval by archive type.
Inbound links
Answers what links here after building a link graph.
Integrity checks
zim_health validates an archive.
HTTP deployment
Bearer auth, CORS and Docker image.

Good for

  • Answer questions from Wikipedia with no internet
  • Search a Stack Exchange dump as clean Q&A
  • Validate a ZIM file
  • Give a small local model a knowledge base

Pricing

Open source

Free open-source package

Openzim MCP FAQ

Do I need to download archives?

Yes, the server needs a ZIM file; a small test archive and the Kiwix library are mentioned.

How do I install it?

With uv tool install, pip or the Docker image.

What is the default mode?

Simple mode with one tool; advanced mode is selected with a flag or OPENZIM_MCP_TOOL_MODE.

Can it run remotely?

Yes in HTTP mode, with a bearer token.

Is Openzim MCP free?

Yes. Openzim MCP is open source, so you can use and self-host it for free.

How do I add Openzim MCP to Claude Code?

Run this command in your terminal: claude mcp add openzim-mcp -- uvx openzim-mcp

What are the best alternatives to Openzim MCP?

The closest alternatives to Openzim MCP are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and NeuroStack.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers