vibeTeX Documentation

vibeTeX is an open-source MCP (Model Context Protocol) server for Overleaf and LaTeX. It exposes your Overleaf projects to AI assistants as a suite of typed, safe tools — pull and push over Overleaf's official git bridge, compile to PDF and parse the log, and cross-check every \ref, \cite, and \label before you ship.

vibeTeX is an independent open-source project and is not affiliated with, endorsed by, or sponsored by Overleaf or Digital Science.

30-second quickstart

Add to Claude Code with your Overleaf git token and a project id:

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

Or run it directly:

OVERLEAF_GIT_TOKEN=your_token \
OVERLEAF_PROJECT_ID=your_project_id \
npx -y @oscardvs/vibetex

Then ask your assistant to call overleaf_whoami first — it reports which capability tiers are live right now, so it picks operations that are actually available.

No Overleaf token? vibeTeX still compiles. With a local TeX engine (latexmk, tectonic, or pdflatex) you get latex_compile, latex_log, and the whole quality-check suite, plus one-click Open in Overleaf.

The Overleaf git authentication token is an Overleaf premium feature — get it from your project's Menu → Git. Free-tier users can opt into the experimental session-cookie tier.

What's in the docs

• Capability tiers — the four auto-detected tiers, what each needs, and the capability matrix.
• Configuration — every environment variable: core, compile, ops, and OAuth.
• Project sync — pull, edit, push, history, and file ops over the git bridge.
• Compiling — latex_compile / latex_log / latex_get_pdf, engines, and CLSI.
• Quality checks — outline, reference check, lint, format, word count, and BibTeX.
• Creating projects — one-way "Open in Overleaf" from generated LaTeX.
• Free-tier (experimental) — the unofficial session-cookie tier and its caveats.
• Tools reference — all 26 tools with their parameters.
• Remote hosting — self-host the OAuth remote, or use the paid hosted connector.

Source & license

github.com/oscardvs/vibetex — MIT licensed.