🍃 Overleaf MCP Server

The most comprehensive Model Context Protocol (MCP) server for Overleaf.

18 tools covering full CRUD, LaTeX structure analysis, git history & diff, PDF compilation, and download — all from your AI assistant.

Simple setup — set two environment variables (OVERLEAF_SESSION, optional OVERLEAF_GIT_TOKEN) when registering the MCP server, and you're done.

You: "List my projects"
AI:  [list_projects] You have 5 projects. Which one?

You: "Read main.tex from my thesis"
AI:  [read_file] Here's the content: …

You: "Rewrite the abstract to be more concise"
AI:  [edit_file] ✓ Edited and pushed

You: "Compile and download the PDF"
AI:  [compile_project + download_pdf] PDF saved to ~/Desktop/thesis.pdf ✓

Note: earlier versions shipped an overleaf_setup / overleaf_save_credentials wizard. These tools have been removed — credentials are now read straight from environment variables.

🆚 Comparison with Other Overleaf MCP Servers

Capability	This Project	tamirsida	GhoshSrinjoy	anu2711	Junfei-Z	mjyoo2
Language	Python	Python	JS	Python	JS	JS
Auth	Git + Cookie	Git	Git	Cookie	Git	Git
list_projects	✅	✅	✅	✅	✅	✅
list_files	✅	✅	✅	✅	✅	✅
read_file	✅	✅	✅	✅	✅	✅
get_sections	✅	✅	✅	❌	✅	✅
get_section_content	✅	✅	✅	❌	✅	✅
create_file	✅	✅	❌	✅	❌	❌
create_project	✅	✅	❌	❌	❌	❌
edit_file (surgical)	✅	✅	✅*	✅	✅*	❌
rewrite_file	✅	✅	✅	✅	✅	❌
update_section	✅	✅	❌	❌	❌	❌
delete_file	✅	✅	❌	❌	❌	❌
list_history	✅	❌	✅	❌	❌	❌
get_diff	✅	❌	✅	❌	❌	❌
compile_project	✅	❌	❌	✅	❌	❌
download_pdf	✅	❌	❌	✅	❌	❌
download_log	✅	❌	❌	❌	❌	❌
sync_project	✅	✅	❌	❌	❌	❌
status_summary	✅	❌	✅	❌	✅	✅
Multi-project	✅	✅	✅	✅	✅	✅
Thread-safe locking	✅	❌	✅ (Redis)	❌	❌	❌
Docker support	✅	❌	✅	❌	❌	❌
Free Overleaf tier	✅†	❌	❌	✅	❌	❌
Total tools	18	12	9	6	8	6

* Full file rewrite only, not surgical old→new replacement. † Compile/download tools work on the free tier via session cookie; Git-based tools require Git integration.

✨ Key Advantages

18 tools — the most of any Overleaf MCP server
Zero config — just two env vars, no config files, no per-project setup
Dual auth — Git tokens for read/write + session cookies for compile/download
Surgical edits — edit_file does exact search-and-replace (like sed), not full rewrites
LaTeX-aware — section hierarchy parsing with indented previews
Git history & diff — review changes, compare versions, filter by file/date
Compilation — trigger builds and download PDFs without leaving your AI chat
Compilation logs — download_log for debugging LaTeX errors
Thread-safe — per-project locks prevent concurrent git corruption
Clean Python — modular architecture, type hints, async throughout

📦 Installation

Option 1: pip (recommended)

# Core (git-based tools only)
pip install overleaf-mcp

# With compile/download support
pip install overleaf-mcp[compile]

Option 2: From source

git clone https://github.com/rangehow/overleaf-mcp.git
cd overleaf-mcp
pip install -e .

# Or with uv
uv venv && uv pip install -e .

Option 3: Docker

git clone https://github.com/rangehow/overleaf-mcp.git
cd overleaf-mcp
docker compose build

🔧 Setup

Configure credentials via environment variables. There are two credentials for two different sets of features — you can supply either or both.

Step 1 — Get the session cookie (required)

The overleaf_session2 cookie is HttpOnly, so it can only be read from the browser's DevTools panel (not from JavaScript / the console).

Log into https://www.overleaf.com.
Press F12 → Application tab (Firefox: Storage; Safari: Storage).
Expand Cookies → https://www.overleaf.com.
Copy the Value of the row named overleaf_session2. It starts with s%3A….

Step 2 — Get the git token (optional, for edit tools)

Open https://www.overleaf.com/user/settings.
Scroll to Git Integration → Create Token.
Copy the token (it starts with olp_; shown only once).

Step 3 — Pass them to the server

Point your MCP client at overleaf-mcp and provide the env vars. In Claude Desktop / Claude Code (claude_desktop_config.json or .mcp.json):

{
  "mcpServers": {
    "overleaf": {
      "command": "overleaf-mcp",
      "env": {
        "OVERLEAF_SESSION": "s%3A...",
        "OVERLEAF_GIT_TOKEN": "olp_..."
      }
    }
  }
}

In chatui's MCP catalog the Overleaf card prompts for these two fields at install time — no shell setup needed.

Two credentials, different purposes

Credential	What you can do	When you need it
Session cookie (`overleaf_session2`)	`list_projects`, compile, download PDF, download log, create project	Works on the free tier. Expires ~30 days — refresh when tools start failing with auth errors.
Git token (`olp_...`)	Read/write/edit files, commit history, diffs	Optional. Only if you want to edit files. Requires a paid plan.

You can start with just the cookie and add the git token later.

All Environment Variables

Variable	Description
`OVERLEAF_SESSION`	Session cookie. Required for list_projects / compile / pdf / create_project.
`OVERLEAF_GIT_TOKEN`	Git token. Required for read / edit / history / diff tools.
`OVERLEAF_BASE_URL`	Overleaf URL (default: `https://www.overleaf.com`)
`OVERLEAF_GIT_HOST`	Git host (default: `git.overleaf.com`)
`OVERLEAF_TEMP_DIR`	Local git cache (default: `./overleaf_cache`)
`OVERLEAF_GIT_AUTHOR_NAME`	Git author name (default: `Overleaf MCP`)
`OVERLEAF_GIT_AUTHOR_EMAIL`	Git author email (default: `mcp@overleaf.local`)
`HISTORY_LIMIT_DEFAULT`	Default commit limit (default: `20`)
`HISTORY_LIMIT_MAX`	Max commit limit (default: `200`)
`DIFF_CONTEXT_LINES`	Diff context lines (default: `3`)
`DIFF_MAX_OUTPUT_CHARS`	Max diff size (default: `120000`)

🔌 Client Setup

Docker

{
  "mcpServers": {
    "overleaf": {
      "command": "docker",
      "args": ["compose", "run", "--rm", "-T", "mcp"],
      "cwd": "/path/to/overleaf-mcp",
      "env": {
        "OVERLEAF_SESSION": "s%3A...",
        "OVERLEAF_GIT_TOKEN": "olp_..."
      }
    }
  }
}

(For Claude Desktop / Claude Code see the setup section above.)

🛠️ Tools Reference

Create

Tool	Description
`create_file`	Create a new file (auto-creates folders), commit & push
`create_project`	Create a new blank Overleaf project (requires session cookie)

Read

Tool	Description
`list_projects`	List all projects in your Overleaf account
`list_files`	List files, optionally filtered by extension
`read_file`	Read file contents
`get_sections`	Parse LaTeX section hierarchy with previews
`get_section_content`	Get full content of a section by title
`list_history`	Git commit history (with date/file/limit filters)
`get_diff`	Git diff between refs or working tree
`status_summary`	Project overview: file count, structure, status

Update

Tool	Description
`edit_file`	Surgical search-and-replace (must match exactly once)
`rewrite_file`	Replace entire file contents
`update_section`	Update a LaTeX section body by title
`sync_project`	Pull latest changes from Overleaf

Delete

Tool	Description
`delete_file`	Delete a file, commit & push

Compile & PDF

Tool	Description
`compile_project`	Trigger PDF compilation on Overleaf
`download_pdf`	Download compiled PDF to local path
`download_log`	Download compilation log for debugging

💡 Usage Examples

"List my projects"
"List all files in project 64a1b2c3d4e5f6a7b8c9d0e1"
"Read main.tex"
"Show me the sections in chapter1.tex"
"Get the content of the Introduction section"

"Fix the typo: change 'teh' to 'the' in main.tex"
"Rewrite the abstract with: [new text]"
"Update the Methods section with: [new content]"
"Create a new file references.bib with: [content]"
"Delete the old appendix.tex file"

"Show me the last 5 commits"
"What changed in main.tex since last week?"
"Show the diff between HEAD~3 and HEAD"

"Compile my thesis and tell me if it succeeded"
"Download the PDF to ~/Desktop/thesis.pdf"
"Show me the compilation log — I have an error"

🏗️ Architecture

┌─────────────────┐  MCP (stdio)  ┌──────────────────────────┐
│  AI Assistant    │◄─────────────►│  overleaf-mcp server     │
│  (Claude, etc.)  │               │                          │
└─────────────────┘               │  ┌────────────────────┐  │
                                   │  │ Git Client         │  │── Git HTTPS ──► git.overleaf.com
                                   │  │ (clone/pull/push)  │  │
                                   │  └────────────────────┘  │
                                   │  ┌────────────────────┐  │
                                   │  │ LaTeX Parser       │  │
                                   │  │ (sections/struct)  │  │
                                   │  └────────────────────┘  │
                                   │  ┌────────────────────┐  │
                                   │  │ Compile Module     │  │── HTTPS ──► www.overleaf.com
                                   │  │ (PDF/log download) │  │
                                   │  └────────────────────┘  │
                                   └──────────────────────────┘

Modules:

credentials.py — Read session cookie + git token from environment variables
config.py — Project config + Overleaf endpoints
git_client.py — Git operations (clone, pull, push, diff, history)
latex.py — LaTeX document structure parsing
compile.py — PDF compilation and download (uses session cookie)
server.py — MCP server with 18 tool definitions

🔒 Security

Credentials are read only from environment variables — nothing is persisted to disk by the server
Path traversal protection on all file operations
Per-project thread locks prevent concurrent git corruption
Session cookie expiry surfaces as a clear auth error, prompting the user to refresh OVERLEAF_SESSION

🐳 Self-Hosted Overleaf

For self-hosted Overleaf instances:

export OVERLEAF_BASE_URL="https://your-overleaf.example.com"
export OVERLEAF_GIT_HOST="your-overleaf.example.com"

📄 License

MIT License — see LICENSE for details.

🙏 Acknowledgments

Inspired by and building upon ideas from:

tamirsida/overleaf_mcp — Full CRUD Python server
GhoshSrinjoy/Overleaf-mcp — Redis queue, history/diff
anu2711/overleaf-mcp — Compile/download via session cookie
mjyoo2/OverleafMCP — Original read-only MCP (103 ⭐)
Junfei-Z/overleaf-claude-mcp — Write/push fork

Name		Name	Last commit message	Last commit date
Latest commit History 8 Commits
src/overleaf_mcp		src/overleaf_mcp
.gitignore		.gitignore
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
docker-compose.yml		docker-compose.yml
overleaf_config.example.json		overleaf_config.example.json
pyproject.toml		pyproject.toml

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

🍃 Overleaf MCP Server

🆚 Comparison with Other Overleaf MCP Servers

✨ Key Advantages

📦 Installation

Option 1: pip (recommended)

Option 2: From source

Option 3: Docker

🔧 Setup

Step 1 — Get the session cookie (required)

Step 2 — Get the git token (optional, for edit tools)

Step 3 — Pass them to the server

Two credentials, different purposes

All Environment Variables

🔌 Client Setup

Docker

🛠️ Tools Reference

Create

Read

Update

Delete

Compile & PDF

💡 Usage Examples

🏗️ Architecture

🔒 Security

🐳 Self-Hosted Overleaf

📄 License

🙏 Acknowledgments

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

🍃 Overleaf MCP Server

🆚 Comparison with Other Overleaf MCP Servers

✨ Key Advantages

📦 Installation

Option 1: pip (recommended)

Option 2: From source

Option 3: Docker

🔧 Setup

Step 1 — Get the session cookie (required)

Step 2 — Get the git token (optional, for edit tools)

Step 3 — Pass them to the server

Two credentials, different purposes

All Environment Variables

🔌 Client Setup

Docker

🛠️ Tools Reference

Create

Read

Update

Delete

Compile & PDF

💡 Usage Examples

🏗️ Architecture

🔒 Security

🐳 Self-Hosted Overleaf

📄 License

🙏 Acknowledgments

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages