Skip to content
MCP server

zotio

Local-first Zotero search, library health checks and preview-first edits for agents

Runs locally
Install
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.32.0
Listing updated
4 days ago

Similar MCP servers

About zotio

zotio is an MCP server for files and documents. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

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

{
  "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>"
      }
    }
  }
}

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

Configuration

  • ZOTERO_API_KEYZotero Web API key. Optional for read-only use against the local Zotero desktop app; required to enable writes and reach group libraries.
  • ZOTERO_API_KEYZotero Web API key. Optional for read-only use against the local Zotero desktop app; required to enable writes and reach group libraries.
  • ZOTERO_API_KEYZotero Web API key. Optional for read-only use against the local Zotero desktop app; required to enable writes and reach group libraries.
  • ZOTERO_API_KEYZotero Web API key. Optional for read-only use against the local Zotero desktop app; required to enable writes and reach group libraries.
  • ZOTERO_API_KEYZotero Web API key. Optional for read-only use against the local Zotero desktop app; required to enable writes and reach group libraries.
  • ZOTERO_API_KEYZotero Web API key. Optional for read-only use against the local Zotero desktop app; required to enable writes and reach group libraries.

What it does

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

Pricing

Pricing unknown

Installable free from GitHub releases or Homebrew; licence not shown.

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

How AIPoweredBot checks servers