claucloverleaf
Connect to an Overleaf account and read/write projects live via MCP.
Check the signed-in account/instance and list accessible projects, including archived ones.
List/read project files and numbered text content.
Create/rewrite files, replace exact text, insert/replace line ranges, create folders, upload local LaTeX-related files, rename, move, and delete project items.
Compile projects, inspect LaTeX errors/warnings/logs, and download compiled PDFs locally.
Add anchored comments and review comments/pending tracked changes.
Submit edits as tracked suggestions using
track_changes.Create new blank Overleaf projects.
Provides live read/write access to Overleaf projects through Overleaf's real-time collaboration channel, with tools for managing projects, folders, and files, compiling LaTeX documents, retrieving compilation errors and PDFs, adding comments, and proposing tracked changes.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@claucloverleaf compile my thesis and show LaTeX errors with file and line"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
claucloverleaf
Permet à Claude de lire et d'écrire dans tes projets Overleaf en direct. Tu te connectes une seule fois.
Les modifications passent par le canal de collaboration temps réel d'Overleaf, et non par git. Les collaborateurs les voient donc instantanément, et elles apparaissent dans l'historique du projet sous le compte connecté. Fonctionne sur overleaf.com et sur les instances auto-hébergées.
Installation
cd ~/projets/claucloverleaf
uv sync
uv run playwright install chromium # navigateur utilisé une seule fois, pour la connexionRelated MCP server: claudeleaf
Connexion (une fois)
uv run claucloverleaf login # ouvre Chromium : connecte-toi normalement (SSO/2FA OK)
uv run claucloverleaf --url https://overleaf.monlabo.fr login # instance auto-hébergée
uv run claucloverleaf status # vérifie la sessionSeul le cookie de session est conservé, dans ~/.claucloverleaf/sessions/<hôte>.json (fichier 0600, dossier 0700), un fichier par instance. Aucun mot de passe n'est stocké, et le navigateur de connexion ne laisse rien sur le disque. claucloverleaf logout ferme la session côté Overleaf puis efface tout en local.
Si le navigateur ne s'ouvre pas, connecte-toi dans ton navigateur habituel. Ouvre les outils de développement (F12), puis Application › Cookies, et copie la valeur de overleaf_session2 (ou overleaf.sid sur une instance auto-hébergée). Ensuite :
uv run claucloverleaf login --cookie # saisie masquée (rien dans l'historique du shell)Avec Claude Code (MCP)
claude mcp add -s user claucloverleaf -- uv run --quiet --project ~/projets/claucloverleaf claucloverleaf mcp
# instance auto-hébergée, limitée à deux projets :
claude mcp add -s user claucloverleaf -e OVERLEAF_URL=https://overleaf.monlabo.fr \
-e CLAUCLOVERLEAF_PROJECTS=0123456789abcdef01234567,"Ma thèse" -- uv run --quiet --project ~/projets/claucloverleaf claucloverleaf mcpUtilise --project et non --directory : le serveur garde ainsi le dossier de ta session Claude Code comme dossier courant, et c'est le seul où il peut lire ou écrire des fichiers locaux.
Outils exposés :
Outil | Rôle |
| compte et projets |
| explorer et lire (lignes numérotées) |
| modification ciblée par extrait exact (à privilégier) |
| insérer, remplacer une plage, réécrire ou créer |
| arborescence |
| compiler et obtenir les erreurs LaTeX (fichier et ligne), télécharger le PDF |
| commentaires et modifications suivies |
Les outils d'écriture acceptent track_changes=true : la modification est alors déposée comme suggestion, que l'auteur accepte ou refuse dans Overleaf. Cela nécessite que le suivi des modifications soit disponible sur le projet.
CLI
uv run claucloverleaf projects
uv run claucloverleaf ls "Ma thèse"
uv run claucloverleaf cat "Ma thèse" main.tex
uv run claucloverleaf replace "Ma thèse" main.tex "ancien" "nouveau" [--all] [--track]
uv run claucloverleaf append "Ma thèse" main.tex "\\section{Suite}"
uv run claucloverleaf write "Ma thèse" chapitres/intro.tex intro.tex # crée ou remplace
uv run claucloverleaf upload "Ma thèse" figure.png --folder figures
uv run claucloverleaf compile "Ma thèse" [--warnings] [--log]
uv run claucloverleaf pdf "Ma thèse" these.pdf
uv run claucloverleaf review "Ma thèse" main.texUn projet se désigne par son identifiant, son URL ou son nom exact.
Configuration (facultative)
Variable | Rôle | Défaut |
| instance |
|
| dossier des sessions et du fichier d'état |
|
| projets autorisés : identifiants, ou noms de tes projets, séparés par des virgules | tous |
|
| désactivé |
| dossiers locaux supplémentaires autorisés pour l'envoi de fichiers et l'écriture du PDF (séparés par | aucun |
|
| désactivé |
| délais (s) | 30, 20, 240, 600 |
Sécurité
Contenu non fiable : un document, un commentaire ou un log de compilation peut contenir des instructions écrites par un collaborateur. Le serveur MCP demande à Claude de ne jamais les suivre. Ne coche pas « toujours autoriser » pour les outils qui écrivent, envoient ou suppriment : la demande de confirmation de Claude Code est la meilleure protection.
Fichiers locaux (
overleaf_upload_file,overleaf_download_pdf) :seulement sous le dossier courant ou sous
CLAUCLOVERLEAF_FILE_DIRS(jamais tout$HOME) ;pas via un dossier caché ni un lien symbolique qui sort de ces dossiers ;
seulement des extensions LaTeX, pas de nom évoquant un secret, 50 Mo au maximum ;
un PDF existant n'est pas écrasé sans
overwrite.
Périmètre :
CLAUCLOVERLEAF_PROJECTSetCLAUCLOVERLEAF_READONLYlimitent ce que Claude peut voir et modifier. Un nom ne compte que pour tes propres projets : un projet qu'on te partage sous le même nom ne passe pas.Cookie : il est lié au domaine de l'instance et n'est jamais envoyé ailleurs. Il ne circule qu'en HTTPS, sauf localhost ou
--insecure.Terminal : la CLI neutralise les séquences d'échappement présentes dans les documents (presse-papiers OSC 52, variables utilisateur du terminal).
Pour isoler au maximum, crée un compte Overleaf dédié à Claude et invite-le seulement dans les projets voulus.
Indicateur de compte
~/.claucloverleaf/status (non secret) contient le compte connecté sur chaque instance, avec ⚠ si la session a expiré. Tu peux l'afficher dans ton prompt ou ta barre de terminal.
Développement
uv run pytest # tests unitaires et de bout en bout contre un faux serveur Overleaf (sans réseau)L'architecture et les détails du protocole sont décrits dans CLAUDE.md.
Licence
MIT, voir LICENSE.
Available Tools
18 toolsoverleaf_add_commentA
Attach a review comment to a span of text, like selecting it and commenting in Overleaf.
Inputs: path (required), message (required), project (required), anchor_text (required), +1 more. Returns: result
overleaf_compileARead-only
Compile the project and report LaTeX errors (file, line, message).
Overleaf reports 'success' even when the document has errors (LaTeX recovers), so always look at the error list.
Inputs: project (required), draft, include_log, include_warnings. Returns: result
overleaf_create_folderB
Create a folder (and any missing parents).
Inputs: path (required), project (required). Returns: result
overleaf_create_projectB
Create a new blank Overleaf project.
Inputs: name (required). Returns: result
overleaf_deleteBDestructive
Delete a document, file or folder (folders are deleted with their content).
Inputs: path (required), project (required). Returns: result
overleaf_download_pdfCDestructive
Compile the project and save the resulting PDF locally.
Inputs: project (required), output_path (required), overwrite. Returns: result
overleaf_insert_linesC
Insert new line(s) into a document, before a given line or at the end.
Inputs: path (required), text (required), project (required), before_line, +1 more. Returns: result
overleaf_list_filesARead-only
List every file and folder of a project. 'doc' = editable text, 'file' = binary/asset.
Inputs: project (required). Returns: result
overleaf_list_projectsARead-only
List the Overleaf projects this account can access (id, name, access, last update).
Inputs: include_archived. Returns: result
overleaf_moveC
Move a document, file or folder to another folder.
Inputs: path (required), folder (required), project (required). Returns: result
overleaf_read_fileBRead-only
Read a text document's live content.
Inputs: path (required), project (required), end_line, start_line, +1 more. Returns: result
overleaf_renameC
Rename a document, file or folder in place.
Inputs: path (required), project (required), new_name (required). Returns: result
overleaf_replace_linesADestructive
Replace (or delete) a range of lines. Re-read the file first: line numbers move.
Inputs: path (required), content (required), project (required), end_line (required), +2 more. Returns: result
overleaf_replace_textADestructive
Replace an exact snippet of a document — the preferred way to make targeted edits.
Inputs: path (required), project (required), new_text (required), old_text (required), +2 more. Returns: result
overleaf_reviewARead-only
List a document's comments (with replies) and pending tracked changes.
Inputs: path (required), project (required). Returns: result
overleaf_upload_fileADestructive
Upload a local file (figure, .bib, .sty…) into the project; a same-named file is replaced.
Only files under the working directory or CLAUCLOVERLEAF_FILE_DIRS, outside hidden
folders, with a LaTeX-related extension, are accepted.
Inputs: project (required), local_path (required), name, folder. Returns: result
overleaf_whoamiARead-only
Show which Overleaf account and instance the tools are signed in to.
Inputs: no named parameters. Returns: result
overleaf_write_fileADestructive
Create a text document, or replace an existing one's whole content.
Only the lines that differ are sent, so collaborators' cursors elsewhere are preserved. Missing folders in the path are created.
Inputs: path (required), content (required), project (required), track_changes. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
Tools are mostly distinct across project discovery, file management, editing, compilation, and review. The whole-file, snippet-based, and line-based editing tools overlap somewhat, and compile overlaps with download_pdf, but their descriptions clarify the intended outputs and use cases.
Every tool uses the same overleaf_ prefix and readable snake_case naming. Action-oriented names are predictable, with only harmless variations in whether the resource is explicitly included.
Eighteen tools is above the usual ideal range, but the broad Overleaf workflow justifies most of them. The several specialized editing operations add some weight without making the set excessively large or redundant.
Core project discovery, document and asset CRUD, folder organization, compilation, PDF retrieval, and basic commenting are covered. Review workflows remain incomplete because comments cannot be replied to or resolved and tracked changes cannot be accepted or rejected; project deletion and sharing are also absent.
Related MCP Connectors
Edit your Overleaf LaTeX projects from Claude and ChatGPT; every change is a real Git commit.
Persistent AI LaTeX workspace: edit and compile multi-file projects, export publication-ready PDFs.
Overleaf alternative online LaTeX editor. AI agents edit, comment, and chat. Keep or revert edits.
Collaborative LaTeX editor: edit, compile and share PDFs, with full version history.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceEnables editing Overleaf projects from Claude, with tools to list, read, edit, and sync files via Git.34 PyPIMIT
- AlicenseNot gradedqualityCmaintenanceEnables Claude and AI agents to read and edit Overleaf documents in real time, with support for project listing, document manipulation, LaTeX compilation, and live collaboration.470 npm48MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to read, edit, and compile LaTeX documents in Overleaf projects with tracked changes via the Model Context Protocol.5MIT
- AlicenseBqualityCmaintenanceConnects Claude to your Overleaf account to manage LaTeX projects, edit files, compile, and retrieve PDFs.6195MIT