Gemini CLI

Add zotero-agent to ~/.gemini/settings.json:

{
  "mcpServers": {
    "zotero-agent": { "command": "zot", "args": ["mcp"] }
  }
}

Install the MCP extra first:

uv tool install "zotero-agent[mcp]"   # or: pipx install "zotero-agent[mcp]"
# a Homebrew install already includes it: brew install alex-roc/tap/zotero-agent
zot init && zot ping                   # confirm the bridge is answering

If zot is not on Gemini CLI’s PATH, use the absolute path from which zot.

Gemini CLI also reads a repository’s AGENTS.md, so inside a project you can let it drive the zot CLI directly instead of using MCP. Write the bundled instructions into the repo with zot skill agents-md > AGENTS.md (also on GitHub).

See the MCP overview for the tool list and safety notes.