overleaf-paper-mcp

MCP server for managing academic LaTeX projects in Overleaf: create projects, transfer files, compile documents, inspect compiler output, and download PDFs.

Install

Requirements: Node.js 20+ and Playwright Chromium.

npm install
npx playwright install chromium
npm run build

Run the published package with:

OVERLEAF_EMAIL="your@email.com" \
OVERLEAF_PASSWORD="yourpassword" \
npx -y @youzhijc/overleaf-paper-mcp

Related MCP server: overleaf-mcp

Configuration

Provide credentials as runtime environment variables; do not commit a .env file.

Use absolute paths for local_path and zip_path when possible. Relative paths are accepted only inside OVERLEAF_DATA_DIR/workspace (or the legacy OVERLEAF_WORKSPACE_DIR). With OVERLEAF_DATA_DIR, all local state is kept below one directory:

OVERLEAF_DATA_DIR/
├── workspace/      # downloaded project files and PDFs
└── browser-data/   # Overleaf login session and browser cache

Do not upload or share browser-data/: it can contain your Overleaf login session. Delete workspace/ to clear downloads, browser-data/ to sign out, or the full data directory to reset the MCP.

Workflow

overleaf_list_files (optional)
→ overleaf_download_file
→ edit the local file
→ overleaf_upload_file (overwrite: true when replacing a file)
→ overleaf_compile
→ overleaf_download_pdf

On a visible compilation failure, overleaf_compile clears cached files, retries once, and returns parsed diagnostics plus the compiler log if the retry also fails.

overleaf_upload_file currently writes to the project root. To import a full project archive, use overleaf_create_project_from_zip.

Tools

Codex configuration

[mcp_servers.overleaf-paper-mcp]
command = "npx"
args = ["-y", "@youzhijc/overleaf-paper-mcp"]
env = {
  OVERLEAF_EMAIL = "your@email.com",
  OVERLEAF_PASSWORD = "yourpassword",
  OVERLEAF_DATA_DIR = "/absolute/path/to/your/overleaf-paper-mcp-data"
}
startup_timeout_sec = 120
tool_timeout_sec = 120

License

MIT