# zotio

> zotio is an MCP server for files and documents. Local-first Zotero search, library health checks and preview-first edits for agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, macOS, Linux, Windows
- **Repository:** https://github.com/orgmentem/zotio
- **MCP Registry name:** io.github.OrgMentem/zotio
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-15

## About

zotio treats a Zotero library as something to audit as well as read. Its flagship check, library health, combines citekey conflicts, duplicates, missing metadata, tag drift and broken attachments into one ranked report, tuned by purpose: quick, citation, systematic-review, vault or all. A --fail-on option returns exit code 11, so it can gate a pre-submission hook, and --require-fresh returns 12 when the local mirror is stale.

Reads mostly use the local Zotero desktop API or a synced SQLite mirror and need no key. Web-only reads and most edits need a Zotero Web API key. Writes are preview-first with caps on blast radius, explicit opt-in for irreversible operations and an append-only journal for undoing reversible ones. Context for agents is bounded and tagged with where it came from and how fresh it is, and zotio says it never calls an LLM itself.

A bundled demo library of 34 classic papers includes one genuinely retracted paper, and retract-check queries Retraction Watch data and Crossref. It runs over stdio from per-platform downloads for macOS, Linux and Windows, or installs with Homebrew.

## Features

- **Library health report:** One ranked report of duplicates, missing metadata, citekey conflicts and broken files.
- **Retraction check:** Flags retractions, corrections and expressions of concern, with a CI-friendly exit code.
- **Preview-first writes:** Every mutation shows a plan first; an append-only journal supports undo.
- **Local-first reads:** Uses the desktop app or a synced mirror without a key.
- **Bounded agent context:** Results carry provenance and freshness and fit a token budget.
- **Bibliography checks:** bibcheck verifies that LaTeX citations resolve.

## Good for

- Check a library before submitting a manuscript
- Find items missing PDFs for a systematic review
- Catch retracted papers cited in a thesis
- Keep an Obsidian vault in sync with clean citekeys
- Let an agent edit tags safely after previewing the plan

## Install

### Claude Code (Terminal)

```sh
claude mcp add zotio --env ZOTERO_API_KEY='<ZOTERO_API_KEY>' -- npx -y https://github.com/OrgMentem/zotio/releases/download/v0.32.0/zotio-mcp_0.32.0_darwin_amd64.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "zotio": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/OrgMentem/zotio/releases/download/v0.32.0/zotio-mcp_0.32.0_darwin_amd64.mcpb"
      ],
      "env": {
        "ZOTERO_API_KEY": "<ZOTERO_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "zotio": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/OrgMentem/zotio/releases/download/v0.32.0/zotio-mcp_0.32.0_darwin_amd64.mcpb"
      ],
      "env": {
        "ZOTERO_API_KEY": "<ZOTERO_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "zotio": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/OrgMentem/zotio/releases/download/v0.32.0/zotio-mcp_0.32.0_darwin_amd64.mcpb"
      ],
      "env": {
        "ZOTERO_API_KEY": "<ZOTERO_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "zotio": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/OrgMentem/zotio/releases/download/v0.32.0/zotio-mcp_0.32.0_darwin_amd64.mcpb"
      ],
      "env": {
        "ZOTERO_API_KEY": "<ZOTERO_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "zotio": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/OrgMentem/zotio/releases/download/v0.32.0/zotio-mcp_0.32.0_darwin_amd64.mcpb"
      ],
      "env": {
        "ZOTERO_API_KEY": "<ZOTERO_API_KEY>"
      }
    }
  }
}
```

## FAQ

### Do I need a Zotero API key?

Not for local reads; writes beyond new items and Web-only reads need one.

### Does zotio call an LLM?

No. It assembles context and hands it to the model.

### Can I try it without my library?

Yes. zotio demo seeds a bundled library with no Zotero install or key.

### How do I install it?

With Homebrew, or signed binaries from the GitHub releases.

### How do I add zotio to Claude Code?

Run this command in your terminal: claude mcp add zotio --env ZOTERO_API_KEY='<ZOTERO_API_KEY>' -- npx -y https://github.com/OrgMentem/zotio/releases/download/v0.32.0/zotio-mcp_0.32.0_darwin_amd64.mcpb

### What are the best alternatives to zotio?

The closest alternatives to zotio are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

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

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

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