# Openzim MCP

> Openzim MCP is an open-source MCP server for knowledge and memory. Offline MCP access to ZIM archives such as Wikipedia, Wiktionary and Stack Exchange. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/cameronrye/openzim-mcp
- **MCP Registry name:** io.github.cameronrye/openzim-mcp
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add openzim-mcp -- uvx openzim-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [NeuroStack](https://ai-powered.com/mcp/neurostack): NeuroStack is a freemium MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Digitalnz](https://ai-powered.com/mcp/digitalnz): Digitalnz is a freemium MCP server for knowledge and memory.
- [Notion_connect](https://ai-powered.com/mcp/notion-connect): Notion_connect is a freemium MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/openzim-mcp
