Zotero MCP — Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Recherche par auteur, titre, tag, collection, texte intégral
Récupération du BibTeX/CSL-JSON pour n'importe quel item
Extraction des surlignages et annotations depuis les pièces jointes PDF
Compatible avec l'API locale Zotero 7 et l'API web Zotero
Lecture seule par défaut — sûr à connecter à votre bibliothèque de recherche

Démo en direct

Aperçu en pratique

zotero-mcp.replay ▶ prêt

0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "zotero-mcp",
      "command": "uvx",
      "args": [
        "zotero-mcp"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

{
  "context_servers": {
    "zotero-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "zotero-mcp"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add zotero-mcp -- uvx zotero-mcp

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Zotero MCP

Synthétiser une revue de littérature à partir d'articles tagués

👤 Doctorants, chercheurs ⏱ ~60 min intermediate

Quand l'utiliser : Vous avez tagué 30 articles avec #thesis-ch3 et devez rédiger la section 3.2.

Prérequis

Zotero en cours d'exécution (API locale activée) — Zotero 7 : Préférences → Avancé → activer l'API locale
Clé API si vous utilisez le web — zotero.org/settings/keys

Déroulement

Récupérer la liste

Liste chaque item tagué thesis-ch3 dans mon Zotero. Juste titres + années + premier auteur.✓ Copié

→ Inventaire propre, ~30 items
Regrouper

Regroupe-les par approche méthodologique. Cite chaque item par sa clé Zotero.✓ Copié

→ 3–5 clusters avec citations par cluster
Extraire + rédiger

Pour le cluster « essais contrôlés randomisés », récupère mes surlignages de chaque item et rédige un paragraphe de synthèse avec citations intégrées.✓ Copié

→ Paragraphe avec citations (Auteur, Année) étayées par les surlignages réels

Résultat : Une section 3.2 rédigée à affiner plutôt qu'à repartir de zéro.

Pièges

Le PDF n'a pas de surlignages, juste des scans — Lancez d'abord l'OCR dans Zotero (clic droit → OCR PDF), puis récupérez à nouveau

Combiner avec : filesystem

Générer la bibliographie d'un article en cours de rédaction

👤 Toute personne écrivant en LaTeX ⏱ ~15 min beginner

Quand l'utiliser : Vous avez cité 40 items dans un brouillon et avez besoin d'un fichier references.bib unique.

Déroulement

Scanner les citations

Dans /paper/main.tex, liste chaque clé \cite{}.✓ Copié

→ Toutes les clés de citation énumérées
Résoudre

Pour chacune, récupère le BibTeX depuis Zotero et écris le résultat dans /paper/references.bib. Signale toute clé sans correspondance.✓ Copié

→ Fichier bib écrit ; citations non résolues listées

Résultat : Un fichier references.bib propre lié à votre Zotero — sans copier-coller manuel.

Pièges

Incompatibilité de clés (Better BibTeX vs. par défaut) — Installez l'extension Better BibTeX dans Zotero pour des clés de citation stables et épinglées

Combiner avec : filesystem

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

zotero-mcp + filesystem

Écrire la synthèse extraite dans votre brouillon d'article

Écris la synthèse depuis Zotero dans /paper/section-3-2.md.✓ Copié

zotero-mcp + memory

Mémoriser les arguments clés par article entre les sessions

Stocke la thèse en une phrase de chaque item du cluster A en mémoire.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
search_items	query: str, tag?: str, collection?: str	Trouver des items dans la bibliothèque	free
get_item	key: str	Inspecter un item en détail	free
get_annotations	key: str	Récupérer vos surlignages et notes sur un PDF	free
get_bibtex	keys: str[]	Construire la bibliographie d'un brouillon	free
list_collections	none	Naviguer dans votre organisation	free

Coût et limites

Coût d'exécution

Quota d'API: API locale : illimitée. API web : limitée en débit par Zotero.
Tokens par appel: Métadonnées d'item ~200 tokens ; les annotations peuvent être volumineuses
Monétaire: Gratuit
Astuce: Préférez search_items avec filtres par tag plutôt que de lister tous les items

Sécurité

Permissions, secrets, portée

Portées minimales : library:read

Stockage des identifiants : Clé API en variable d'environnement (mode web uniquement)

Sortie de données : api.zotero.org (mode web) ou localhost (mode local)

Ne jamais accorder : library:write unless truly needed

Dépannage

Erreurs courantes et correctifs

ECONNREFUSED localhost:23119

Zotero n'est pas en cours d'exécution, ou l'API locale est désactivée. Ouvrez Zotero ; Préférences → Avancé → activer l'API locale.

Vérifier : `curl http://localhost:23119/api/users/0/items`

Web API 403

La clé API n'a pas le périmètre de lecture de la bibliothèque. Régénérez sur zotero.org/settings/keys.

Les clés BibTeX sont générées automatiquement de façon incohérente

Installez le module complémentaire Better BibTeX et définissez un format de citekey stable

Alternatives

Zotero MCP vs autres

Alternative	Quand l'utiliser	Compromis
Obsidian MCP	Vos notes sont dans Obsidian, pas Zotero	Modèle de données différent — pas centré sur les articles
Direct Zotero CSL export	Export ponctuel, sans implication de LLM	Pas de requêtes, pas de synthèse

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills