Zotero MCP
Serveur MCP par 54yyyu (Steven Yu)
Rechercher, lire, annoter et ajouter des articles dans votre bibliothèque de recherche Zotero, via l’application locale ou l’API web.
Installer Zotero MCP
Tourne sur votre machine. Votre client le lance avec cette commande :
Nécessite uv (Python) sur votre ordinateur. Les étapes ci-dessous montrent où placer la commande dans chaque client.
ZOTERO_LOCALfacultatif Read from the local Zotero desktop app instead of the web API. Requires Zotero 7+ with the local API enabled in Settings > Advanced.ZOTERO_API_KEYsecret facultatif Zotero Web API key from https://www.zotero.org/settings/keys. Only needed when ZOTERO_LOCAL is false, or for write operations in hybrid…ZOTERO_LIBRARY_IDfacultatif Zotero user or group library ID. Only needed when ZOTERO_LOCAL is false, or for write operations in hybrid mode.ZOTERO_LIBRARY_TYPEfacultatif Whether ZOTERO_LIBRARY_ID refers to a personal or a group library.ZOTERO_MCP_TOOLSETSfacultatif Which optional tool groups to expose, as a comma-separated list. Every tool is sent to the model on each request, so optional capabilities…
Partager ce serveur
Ouvre cette page, avec la commande d’installation et les étapes de configuration.
mcp.tc/i/zoteroPrésentation
Connecte un assistant IA à une bibliothèque de recherche Zotero. Vous pouvez rechercher par titre, auteur, tag, collection, texte intégral ou sens (recherche sémantique), lire les métadonnées, le BibTeX et le texte des PDF, placer des surlignages et des notes sur les PDF, et ajouter des articles par DOI, URL, ISBN, BibTeX ou fichier. Les collections, tags et doublons peuvent être gérés, et les décomptes de citations Scite sont disponibles en option.
Fonctionne en local via stdio sous la forme du paquet Python zotero-mcp-server (uvx ou pip, Python 3.10+). Le mode local lit depuis l’application de bureau Zotero 7+ avec son API locale activée et ne nécessite aucune clé. Le mode web ou hybride nécessite ZOTERO_API_KEY et ZOTERO_LIBRARY_ID. Les groupes d’outils facultatifs se choisissent avec ZOTERO_MCP_TOOLSETS.
Ce que vous pouvez faire
- Rechercher dans la bibliothèque par titre, auteur, tag, collection, texte intégral ou sens
- Lire les métadonnées d’un élément, le BibTeX, le texte intégral et des plages de pages de PDF
- Créer des surlignages, des zones et des notes sur les PDF
- Ajouter des articles par DOI, URL, ISBN, BibTeX ou fichier
- Gérer les collections et les tags et fusionner les doublons
- Vérifier les décomptes de citations et les alertes de rétractation avec Scite (facultatif)
Outils
Les serveurs locaux présentent leurs outils une fois lancés, nous ne pouvons donc pas les afficher ici. Cherchez la liste dans sa documentation ; votre client les affiche après l’ajout.
Exemples de prompts
Trouve les articles de ma bibliothèque sur les mécanismes d’attention
Résume les principaux résultats de cet article
Surligne les affirmations principales de ce PDF
Ajoute l’article avec le DOI 10.1000/xyz123 à ma bibliothèque Zotero
Configuration
Chaque client lance Zotero MCP sur votre machine avec la même commande. Choisissez le vôtre ; la page retient votre choix.
Claude Code
- Lancez ceci dans un terminal, dans le dossier de votre projet :
claude mcp add --transport stdio zotero --env "ZOTERO_API_KEY=<YOUR_ZOTERO_API_KEY>" -- uvx --from zotero-mcp-server zotero-mcp serve- Démarrez Claude Code et tapez
/mcp. zotero devrait apparaître comme connecté.
Ajoutez --scope user pour le rendre disponible dans tous vos projets. Remplacez les espaces réservés par vos propres valeurs.
Claude Desktop
- Ouvrez Settings → Developer → Edit Config. Cela ouvre
claude_desktop_config.json. Ajoutez :
{
"mcpServers": {
"zotero": {
"command": "uvx",
"args": [
"--from",
"zotero-mcp-server",
"zotero-mcp",
"serve"
],
"env": {
"ZOTERO_API_KEY": "<YOUR_ZOTERO_API_KEY>"
}
}
}
}- Enregistrez le fichier et redémarrez Claude Desktop. Remplacez les espaces réservés par vos propres valeurs.
Nécessite uv (Python) sur votre ordinateur. Le fichier se trouve dans ~/Library/Application Support/Claude/ sous macOS et dans %APPDATA%\Claude\ sous Windows.
Cursor
Ajouter à Cursor (s’ouvre dans un nouvel onglet)
Ou ajoutez-le à la main dans ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (ce projet) :
{
"mcpServers": {
"zotero": {
"command": "uvx",
"args": [
"--from",
"zotero-mcp-server",
"zotero-mcp",
"serve"
],
"env": {
"ZOTERO_API_KEY": "<YOUR_ZOTERO_API_KEY>"
}
}
}
}Nécessite uv (Python) sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.
VS Code
Ajoutez-le à .vscode/mcp.json. VS Code demande le secret la première fois et le stocke de façon sécurisée :
{
"servers": {
"zotero": {
"type": "stdio",
"command": "uvx",
"args": [
"--from",
"zotero-mcp-server",
"zotero-mcp",
"serve"
],
"env": {
"ZOTERO_API_KEY": "${input:zotero-api-key}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "zotero-api-key",
"description": "ZOTERO_API_KEY",
"password": true
}
]
}Nécessite uv (Python) sur votre ordinateur.
Devin Desktop
- Ajoutez-le à
~/.config/devin/mcp_config.json(macOS et Linux) ou%APPDATA%\devin\mcp_config.json(Windows) :
{
"mcpServers": {
"zotero": {
"command": "uvx",
"args": [
"--from",
"zotero-mcp-server",
"zotero-mcp",
"serve"
],
"env": {
"ZOTERO_API_KEY": "<YOUR_ZOTERO_API_KEY>"
}
}
}
}- Actualisez la liste des serveurs MCP dans Cascade. Remplacez les espaces réservés par vos propres valeurs.
Devin Desktop est le nouveau nom de Windsurf.
Codex
codex mcp add zotero --env "ZOTERO_API_KEY=<YOUR_ZOTERO_API_KEY>" -- uvx --from zotero-mcp-server zotero-mcp serveOu modifiez directement ~/.codex/config.toml :
[mcp_servers.zotero]
command = "uvx"
args = ["--from", "zotero-mcp-server", "zotero-mcp", "serve"]
env = { ZOTERO_API_KEY = "<YOUR_ZOTERO_API_KEY>" }Nécessite uv (Python) sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.
Gemini CLI
gemini mcp add -e "ZOTERO_API_KEY=<YOUR_ZOTERO_API_KEY>" zotero uvx -- --from zotero-mcp-server zotero-mcp serveCela l’ajoute au projet en cours. Ajoutez -s user pour l’utiliser partout.
Tout client
La plupart des clients qui lancent des serveurs locaux acceptent cette forme :
{
"mcpServers": {
"zotero": {
"command": "uvx",
"args": [
"--from",
"zotero-mcp-server",
"zotero-mcp",
"serve"
],
"env": {
"ZOTERO_API_KEY": "<YOUR_ZOTERO_API_KEY>"
}
}
}
}Zed place les serveurs sous context_servers dans ses réglages, avec les mêmes champs command, args et env.
Nécessite uv (Python) sur votre ordinateur. Remplacez les espaces réservés par vos propres valeurs.
Intégrer
Affichez Zotero MCP dans un README ou sur votre site. Chaque intégration renvoie à cette page, utilise la commande d’installation du serveur et ne dépose aucun cookie. Comment fonctionnent les intégrations
La carte, l’iframe et le JSON sont en anglais. Ajoutez ?lang=it, fr, de ou es à leur adresse pour une autre langue.
Badge pour README
[](https://mcp.tc/i/zotero)<a href="https://mcp.tc/i/zotero"><img src="https://mcp.tc/i/zotero/badge.svg" alt="Zotero MCP on mcp.tc" height="20"></a>Il suit le mode clair ou sombre du lecteur. Ajoutez ?theme=light ou ?theme=dark pour le fixer, ou ?style=compact pour afficher le symbole sans le nom.
Carte pour site web
<script src="https://mcp.tc/w/zotero.js" async></script>La carte apparaît à l’endroit de la balise. Ajoutez data-theme="dark" ou data-size="compact" à la balise pour la modifier. Le fichier contient tout ce qu’il lui faut : il ne fait aucune autre requête et ne dépose aucun cookie.
iframe
<iframe src="https://mcp.tc/embed/zotero" title="Zotero MCP on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>Utilisez-la sur les pages qui n’autorisent pas les scripts. Ajoutez ?theme=light ou ?theme=dark à l’adresse pour fixer les couleurs.
JSON
La fiche sous forme de données pour vos pages et vos outils : nom, accroche, commande d’installation, outils et liens « Add to ». N’importe quel site peut la lire (CORS ouvert).
https://mcp.tc/i/zotero.jsonPrompt pour l’IA
Collez-le dans un assistant de code IA, comme Claude Code ou Cursor, et il ajoutera la carte de Zotero MCP à votre site.
Ajoute à mon site la carte mcp.tc de Zotero MCP, un serveur MCP. C’est un seul script statique : pas de build, aucun paquet à installer, aucun cookie.
Place cette balise là où la carte doit apparaître. La carte s’affiche juste avant elle :
```html
<script src="https://mcp.tc/w/zotero.js" async></script>
```
Pour l’afficher ailleurs, mets ce conteneur à cet endroit et charge le même script une seule fois, par exemple avant `</body>`. Garde le lien à l’intérieur : les visiteurs sans JavaScript le voient.
```html
<div data-mcptc="zotero"><a href="https://mcp.tc/i/zotero">Zotero MCP on mcp.tc</a></div>
```
Options :
- `data-theme="light"` ou `"dark"` sur la balise ou le conteneur fixe les couleurs. Sans cela, la carte suit le mode clair ou sombre du visiteur.
- `data-size="compact"` donne une carte plus petite, sans l’accroche.
- La variable CSS `--mcptc-max-width` sur le conteneur ou un parent fixe la largeur (`520px` par défaut).
- `?lang=` dans l’URL du script choisit la langue de la carte : `en`, `it`, `fr`, `de` ou `es`.
Si le site a une Content Security Policy, autorise `script-src https://mcp.tc` et `img-src data:` (l’icône est intégrée).
Pour un README ou une autre doc en Markdown, utilise plutôt le badge :
```markdown
[](https://mcp.tc/i/zotero)
```
Référence : https://mcp.tc/fr/embedHistorique des changements
Ce serveur tourne sur votre ordinateur, donc nous suivons son paquet PyPI : chaque nouvelle version apparaît ici, avec les modifications de son propriétaire.
-
Nouvelle version 0.17.2 (avant : 0.17.1). Lue sur PyPI.
-
Nouvelle version 0.17.1 (avant : 0.17.0). Lue sur PyPI.
-
Nouvelle version 0.16.0 (avant : 0.15.2). Lue sur PyPI.
-
Nouvelle version 0.15.2 (avant : 0.15.1). Lue sur PyPI.
-
Nouvelle version 0.15.1 (avant : 0.15.0). Lue sur PyPI.
-
Nouvelle version 0.15.0 (avant : 0.14.1). Lue sur PyPI.
-
Nouvelle version 0.14.1 (avant : 0.14.0). Lue sur PyPI.
-
Nouvelle version 0.13.3 (avant : 0.13.2). Lue sur PyPI.
-
Début de l’observation : version 0.13.2.
FAQ
Puis-je coller mcp.tc/i/zotero dans mon client MCP ?
Non. Zotero MCP tourne sur votre propre ordinateur, lancé par votre client, il n’a donc pas d’adresse web à laquelle se connecter. Le lien rapide est la page à partager ; la commande d’installation est uvx --from zotero-mcp-server zotero-mcp serve.
Zotero MCP a-t-il besoin d’une clé API ?
Oui. Il lit ZOTERO_API_KEY dans son environnement, et ZOTERO_API_KEY est un secret. Mettez la valeur dans la configuration de votre client, sur votre propre machine, jamais dans un fichier partagé.
Zotero MCP est-il un serveur distant ou local ?
Local. Votre client le lance comme un processus sur votre ordinateur avec uvx --from zotero-mcp-server zotero-mcp serve, qui nécessite uv (Python).
Que peut faire Zotero MCP ?
Vous pouvez rechercher dans la bibliothèque par titre, auteur, tag, collection, texte intégral ou sens, lire les métadonnées d’un élément, le BibTeX, le texte intégral et des plages de pages de PDF et créer des surlignages, des zones et des notes sur les PDF.
Quels clients peuvent l’utiliser ?
Tout client qui lance des serveurs locaux : Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed et d’autres. claude.ai et ChatGPT ne se connectent qu’à des serveurs distants.
mcp.tc suit-il les changements de Zotero MCP ?
En partie. Il tourne sur votre ordinateur, donc nous suivons son paquet PyPI : son onglet Historique montre chaque nouvelle version et les modifications de son propriétaire. Suivez la fiche pour recevoir un e-mail quand elle change.
Qui a rédigé cette page ?
Le robot de mcp.tc a lu les métadonnées publiques de Zotero MCP (ses pages de paquet et de dépôt), et un modèle d’IA en a tiré le texte. Une personne examine tout ce que les vérifications ne peuvent pas confirmer. Le texte peut encore contenir des erreurs : si vous en repérez une, utilisez Signaler cette fiche sur cette page. Cette traduction a été réalisée par un modèle d’IA à partir du texte anglais.
mcp.tc n’est pas affilié à 54yyyu (Steven Yu). Cette page a été construite à partir des métadonnées publiques de Zotero MCP, vérifiées pour la dernière fois le 3 oct. 2026, et un modèle d’IA a rédigé la description : elle peut contenir des erreurs. Les noms et marques appartiennent à leurs propriétaires. Quelque chose cloche ? Signaler cette fiche. La traduction a été réalisée par un modèle d’IA à partir du texte anglais.