Codex CLI

Codex CLI can use zotero-agent two ways.

Via MCP

Add to ~/.codex/config.toml:

[mcp_servers.zotero-agent]
command = "zot"
args = ["mcp"]

Install the MCP extra first (uv tool install "zotero-agent[mcp]" — a Homebrew install already includes it) and verify with zot ping.

Via the CLI + AGENTS.md

Codex also reads a repository’s AGENTS.md, so inside a project you can skip MCP entirely and let it call the zot CLI directly. The instructions ship with the package — write them into any repo:

zot skill agents-md > AGENTS.md    # or  >>  to append to an existing one

That file (also on GitHub) documents the read commands, the guarded write commands, the JSONL batch-edit flow (zot apply / zot undo), and the safety rules — everything Codex needs to operate the library from the shell.

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