Overleaf MCP Server

1# Overleaf MCP Server
2 
3An MCP server focused only on Overleaf projects (via Overleaf Git sync).
4 
5## Quick Start
6 
7```bash
8git clone https://github.com/younesbensafia/overleaf-mcp-server.git
9cd overleaf-mcp-server
10 
11uv sync
12 
13# Configure environment
14cp .env.example .env
15# then edit .env with your token/project id
16 
17PYTHONPATH=. uv run src/main.py
18```
19 
20## Environment
21 
22`.env` example:
23 
24```env
25OVERLEAF_TOKEN=your_git_token
26PROJECT_ID=your_project_id
27# Optional local clone dir:
28OVERLEAF_REPO_DIR=/tmp/overleaf_repos
29```
30 
31Notes:
32- `OVERLEAF_TOKEN` is required.
33- `project_id` can be passed per tool call, or use default `PROJECT_ID`.
34- Overleaf Git access requires a plan that supports Git integration.
35 
36## Claude Desktop Setup
37 
38Add to `~/.config/Claude/claude_desktop_config.json`:
39 
40```json
41{
42  "mcpServers": {
43    "overleaf": {
44      "command": "uv",
45      "args": ["--directory", "/path/to/overleaf-mcp-server", "run", "src/main.py"],
46      "env": {
47        "PYTHONPATH": ".",
48        "OVERLEAF_TOKEN": "your_git_token",
49        "PROJECT_ID": "your_project_id"
50      }
51    }
52  }
53}
54```
55 
56## Tools
57 
58| Tool | Description |
59|------|-------------|
60| `list_files` | Pull and list files from Overleaf project |
61| `read_file` | Read file content |
62| `write_file` | Update file, commit, and push to Overleaf |
63| `sync_project` | Force a pull/sync from Overleaf |
64 
65## Requirements
66 
67- Python 3.13+
68- `uv` package manager
69 
70## License
71 
72MIT - See [LICENSE](LICENSE)
73