overleaf_upload_folder
Uploads a local directory recursively to an Overleaf project via web session or Git Bridge push, with options for target subfolders, ignore patterns, and removing deleted files.
Instructions
Upload an entire local directory (recursively) to an existing Overleaf project.
Supports both Web Session upload (works on Free & Paid accounts) and Git Bridge push (Paid/Institutional).
Args: project: Overleaf project ID, project URL, or exact project title. local_dir: Local folder whose contents will be uploaded. remote_dir: Optional target subdirectory in Overleaf (Web mode; e.g. 'figures'). Empty uploads to project root. method: 'web' (session cookie API), 'git' (Git Bridge commit & push), or 'auto' (prefers 'git' when token + root upload, else 'web'). commit_message: Git commit message when using method='git'. delete_missing_in_git: In 'git' mode, remove remote files that no longer exist in local_dir. ignore_patterns: Optional filename/directory globs to ignore (defaults skip .git, .DS_Store, *.aux, etc.).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"project": "<project>",
"local_dir": "<local_dir>"
},
"name": "overleaf_upload_folder"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| method | No | auto | |
| project | Yes | ||
| local_dir | Yes | ||
| remote_dir | No | ||
| commit_message | No | Sync folder via Overleaf MCP Agent | |
| ignore_patterns | No | ||
| delete_missing_in_git | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |