Skip to contents

Configuration and HTTP access

Configure access, read API resources, paginate, and move items to Trash.

zotConfig()
Configure Zotero API access
zotLibraryPath()
Build a Zotero library API path
zotRequest() zotGet() zotPost() zotPatch()
Perform one Zotero API request
zotGetAll()
Fetch every page of a listing endpoint
zotTrash()
Move items to the recoverable Trash

Batch execution

Preview, record, execute, resume, and sample a mutation batch.

zotPreview()
Preview a batch plan
zotApprove()
Create an approval record for a preview
zotExecute()
Execute a previewed batch with a resumable ledger
zotVerify()
Census a ledger against its plan

Batch files

Persist plans, previews and approvals between processes.

zotWriteBatch()
Write a plan, preview or approval as a batch file
zotReadBatch()
Read a batch file written by zot

Catalog reads

Probe the data planes and read libraries, collections and items.

zotStatus()
Probe the data planes zot can reach
zotLibraries()
List the personal library and the accessible groups
zotCollections()
List the collections of a library with their paths
zotItems()
Read items by key
zotListItems()
List items with a declared bound

Local and identity reads

Query local or semantic data and compare bibliographic identity.

zotLocalQuery()
Read-only query over the local Zotero database
zotLocalItems()
List items from the local database
zotLocalRecords()
Read bibliographic records with their identity fields from the local database
zotLocalFiles()
Locate attachment files in the local Zotero storage
zotSameItem()
Strong-identity comparison of two bibliographic records
zotIdentity()
Map a record to the fields compared by strong identity
ztMatches()
Match candidate records against a set of records by strong identity
ztSemantic()
Query the semantic index built by zotero-mcp

Batch operations

Build curation plans and perform explicitly effectful integrations.

ztCensus()
Census a library through the API
ztRetitle()
Build a retitle plan from a deterministic transformation
ztRefile()
Build a refile plan that adds items to a collection
ztCollectionTree()
Ensure a collection tree exists in a library
ztBlockMoveCreate()
Build the create half of a block move
ztBlockMoveTrash()
Build the trash half of a block move from its executed create ledger
ztCrossref()
Map a Crossref record to a Zotero item payload
ztTemplate()
Fetch the field template of an item type
ztCheckPayload()
Check a create payload against its item type template
ztTwins()
Detect duplicate candidates with evidence classes
ztAttach()
Attach a local file to an existing item

Payload sanitation

Normalize source labels, copy suffixes, and file extensions.

ztCleanName()
Normalize an incoming filename
ztCleanTitle()
Normalize an incoming title
ztCleanPayload()
Sanitize every text field of an incoming item payload