Open-source · Overleaf MCP server

Overleaf and LaTeX,
for Claude and
other MCP clients.

vibeTeX is an MCP server for LaTeX and Overleaf projects: a Git bridge, project sync, and LaTeX compile for Claude and other MCP clients. Pull, edit, push, build the PDF, and check references from the chat.

View on GitHub

MIT-licensed · 26 tools · Local compile · Self-host free

Claude · vibeTeX connected

Pull my thesis from Overleaf, compile it, and fix any broken references.

overleaf_pulllatex_compilelatex_check_refs

Pulled thesis via the git bridge and compiled with latexmk: PDF built, 0 errors. One cross-reference was dangling: \ref{fig:results} pointed at a figure whose label is actually fig:main-results.

edited chapters/results.tex · line 142
- see Figure \ref{fig:results}
+ see Figure \ref{fig:main-results}

Pushed the fix back to Overleaf. Recompiled clean; every \ref and \cite now resolves.

Works withClaude DesktopClaude CodeCursorVS CodeZedGemini CLI
Install

Install with one command.

Local compile needs a TeX install and no Overleaf account. Add your Overleaf git token and a project id for read, write, and history over the official git bridge.

Claude Code

claude mcp add vibetex \
  -e OVERLEAF_GIT_TOKEN=your_token \
  -e OVERLEAF_PROJECT_ID=your_id \
  -- npx -y @oscardvs/vibetex

Cursor / VS Code (mcp.json)

"vibetex": {
  "command": "npx",
  "args": ["-y","@oscardvs/vibetex"],
  "env": { "OVERLEAF_GIT_TOKEN": "…",
           "OVERLEAF_PROJECT_ID": "…" }
}

claude.ai (hosted, paid)

Add a custom connector →
https://mcp.vibetex.dev/mcp

Your paper lives in Overleaf.
Your assistant can work on it there.

Without a bridge, you copy a section into chat, paste the suggestion back, switch tabs to compile, hunt the log for the error, then find a dangling \ref. With vibeTeX, your assistant pulls, edits, pushes, compiles, and reference-checks the project itself.

Features

Four capability tiers, detected at startup.

vibeTeX uses whichever tiers your environment supports: the paid git token, local compile, no-auth project creation, or the experimental free-tier sync. overleaf_whoami reports which tiers are active.

Git bridge

Read, write, and commit history over Overleaf’s official git bridge. Pull, edit, push, and diff a local working copy of your project. Requires a paid Overleaf git token.

Local & CLSI compile

Build to PDF and parse the log with latexmk, tectonic (no TeX Live needed), or pdflatex, or point at a self-hosted CLSI. No Overleaf account is needed to compile locally.

Reference check

latex_check_refs checks every \ref, \cite, and \label against your .bib files and document, so your assistant can repair the dangling ones.

Open in Overleaf

No account or auth needed: turn generated LaTeX into a new Overleaf project (one-way).

Free tier (experimental)

An opt-in, experimental session-cookie tier gives free Overleaf users list, pull, push, and compile. It is unofficial and off by default.

26 tools

Discovery, project sync, compile, and quality checks: outline, lint, format, word count, and BibTeX. Your git token stays in your own environment and is used only to talk to Overleaf.

Read the docs
Pricing

Self-host for free, or pay once for hosting.

Self-hosted

Free

MIT-licensed. Run it yourself.

  • · Every feature
  • · Runs on your machine with your own tokens
  • · Self-host the OAuth remote for a team

Hosted

€30/year

pay once · 1-year license. A hosted connector, so there is nothing to run yourself.

  • · Connect in claude.ai as a custom connector
  • · One-time license key, 1-year expiry
  • · You keep your data & tokens
See hosted plan

Install vibeTeX

One npx command. Open-source, MIT-licensed, and free to self-host.

View on GitHub