Labsco
BirdInTheTree logo

zotero-mcp

★ 2

from BirdInTheTree

Read+write MCP server for Zotero with full write support — create items, manage collections, find and merge duplicates, import BibTeX

🔥🔥🔥🔥✓ VerifiedAccount requiredAdvanced setup
#git#translation

zotero-mcp

Read+write MCP server for Zotero. An MCP server with full write support for managing Zotero library from AI assistants.

It lets you create items, manage collections, find and merge duplicates, and import BibTeX from within Claude Code/Desktop, or any MCP-compatible client.

Uses the Zotero Web API (requires API key). Get the key at https://www.zotero.org/settings/keys.

Features

Search & Read

ToolDescription
search_itemsFull-text search with collection, type, and tag filters
get_itemDetailed metadata or BibTeX export for a single item
get_collectionsList all collections with hierarchy and item counts
get_collection_itemsList items in a specific collection
find_duplicatesFind duplicates by title/DOI, or scan entire library
get_tagsList all tags with item counts

Write

ToolDescription
create_itemCreate item from field data
create_item_from_doiCreate item by DOI (auto-fills metadata via Zotero translator + CrossRef)
import_bibtexImport BibTeX entries into a collection
update_itemUpdate item fields with version conflict protection

Collections

ToolDescription
create_collectionCreate a collection (with optional parent)
add_to_collectionsAdd an item to multiple collections at once
remove_from_collectionRemove item from collection (doesn't delete it)

Management

ToolDescription
merge_duplicatesMerge duplicates: transfer metadata, tags, collections to keeper, delete rest
delete_itemDelete an item

Examples

Once connected, you can ask your AI assistant things like:

  • "Search my Zotero for papers ..."
  • "Create a new collection called ..."
  • "Import this BibTeX into my collection"
  • "Find duplicate items in my library and merge them"
  • "Add this paper to both collections"
  • "Look up DOI 10.1234/example and add it to my library"

Development

# Install with dev dependencies
uv sync --dev

# Run tests
uv run pytest tests/ -v