mcp-overleaf

# mcp-overleaf An MCP server and Skills bundle for finishing a LaTeX paper: bibliography hygiene, venue compliance, latexdiff for rebuttals, and section critique. Pulls from Overleaf via git, runs the checks locally, and never pushes without explicit confirmation. Pre-release. Not on PyPI yet; install from source. ## Install ```bash git clone https://github.com/yourname/mcp-overleaf cd mcp-overleaf pip install -e . ``` You'll also need: - Python 3.11+ - `latexmk` and `latexdiff` on PATH (any modern TeX distribution) - An Overleaf paid plan if you want git push/pull; otherwise point the tools at a local checkout (Menu → Download → Source `.zip`, unzipped) Run `mcp-overleaf doctor` to verify the environment. ## Register with your agent ```bash mcp-overleaf mcp install claude --project ~/papers/my-paper # or: mcp-overleaf mcp install cursor --project ~/papers/my-paper ``` Restart the client. ## Skills In Claude Code or Cursor: - `/prep-for-submission <venue>`: full pre-submission pass - `/check-bibliography`: DOIs, outdated arXiv preprints, duplicates - `/format-for-venue <venue>`: venue rule check - `/critique-section <section>`: section critique, four lenses - `/draft-related-work`: drafts a paragraph; citations are filtered against a verified allowlist so the model can't fabricate references - `/diff-since-last-submission`: latexdiff PDF Slow path (deliberately not part of the 90-second `/prep-for-submission` budget): - `mcp-overleaf check-pages <venue> <path>`: compile and verify page limit ## Supported venues NeurIPS 2026, ICML 2026, ICLR 2027, ACL 2026, EMNLP 2026, CVPR 2027. Adding a venue is a YAML file and a pull request. See [venues/_schema.yaml](venues/_schema.yaml) and the existing packs. ## Air-gapped mode Set `MCP_OVERLEAF_LLM_BACKEND=ollama` to route critique/draft calls through a local [Ollama](https://ollama.com) instead of Anthropic's API. With `ollama` selected, no part of the workflow contacts a remote LLM. ## Privacy Document text never leaves your laptop except when you explicitly invoke `critique_section` or `draft_section`. Bibliography lookups send public metadata (titles, DOIs, arXiv IDs), not paper body content. See [docs/privacy.md](docs/privacy.md). ## Docs - [docs/quickstart.md](docs/quickstart.md) - [docs/overleaf-setup.md](docs/overleaf-setup.md): git token flow, free vs. paid plans, self-hosted notes - [docs/tools.md](docs/tools.md): raw MCP tool reference - [docs/privacy.md](docs/privacy.md) - [CONTRIBUTING.md](CONTRIBUTING.md): venue packs are the most useful contribution ## License [MIT](LICENSE).