Skip to main content
Glama
claucloverleaf

claucloverleaf

by SolthaX

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 connexion

Related 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 session

Seul 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 mcp

Utilise --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

overleaf_whoami, overleaf_list_projects, overleaf_create_project

compte et projets

overleaf_list_files, overleaf_read_file

explorer et lire (lignes numérotées)

overleaf_replace_text

modification ciblée par extrait exact (à privilégier)

overleaf_insert_lines, overleaf_replace_lines, overleaf_write_file

insérer, remplacer une plage, réécrire ou créer

overleaf_create_folder, overleaf_upload_file, overleaf_rename, overleaf_move, overleaf_delete

arborescence

overleaf_compile, overleaf_download_pdf

compiler et obtenir les erreurs LaTeX (fichier et ligne), télécharger le PDF

overleaf_add_comment, overleaf_review

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.tex

Un projet se désigne par son identifiant, son URL ou son nom exact.

Configuration (facultative)

Variable

Rôle

Défaut

OVERLEAF_URL

instance

https://www.overleaf.com

CLAUCLOVERLEAF_HOME

dossier des sessions et du fichier d'état

~/.claucloverleaf

CLAUCLOVERLEAF_PROJECTS

projets autorisés : identifiants, ou noms de tes projets, séparés par des virgules

tous

CLAUCLOVERLEAF_READONLY

1 : lecture seule (les outils d'écriture ne sont même pas proposés)

désactivé

CLAUCLOVERLEAF_FILE_DIRS

dossiers locaux supplémentaires autorisés pour l'envoi de fichiers et l'écriture du PDF (séparés par :)

aucun

OVERLEAF_ALLOW_HTTP

1 : accepter une instance en http:// hors localhost (équivalent de --insecure)

désactivé

CLAUCLOVERLEAF_REQUEST_TIMEOUT, …_CONNECT_TIMEOUT, …_COMPILE_TIMEOUT, …_LOGIN_TIMEOUT

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_PROJECTS et CLAUCLOVERLEAF_READONLY limitent 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 tools
overleaf_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_compileA
Read-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_deleteB
Destructive

Delete a document, file or folder (folders are deleted with their content).

Inputs: path (required), project (required). Returns: result

overleaf_download_pdfC
Destructive

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_filesA
Read-only

List every file and folder of a project. 'doc' = editable text, 'file' = binary/asset.

Inputs: project (required). Returns: result

overleaf_list_projectsA
Read-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_fileB
Read-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_linesA
Destructive

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_textA
Destructive

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_reviewA
Read-only

List a document's comments (with replies) and pending tracked changes.

Inputs: path (required), project (required). Returns: result

overleaf_upload_fileA
Destructive

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_whoamiA
Read-only

Show which Overleaf account and instance the tools are signed in to.

Inputs: no named parameters. Returns: result

overleaf_write_fileA
Destructive

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

    A3.5/5.0

    Scored across 18 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    Related MCP Servers