list_projects
Retrieve accessible Overleaf projects, newest first, with filters for tags, names, archived, and trashed status, returning IDs, metadata, and totals to help you find and manage projects.
Instructions
List the projects the account can access, newest first by default. Archived and trashed projects are hidden unless includeArchived or includeTrashed is set. Returns projects with id, name, accessLevel, lastUpdated, archived, and trashed, plus totalMatched (before limit) and totalProjects (everything the account can access). includeTags adds each project's tags ({ id, name }) and tags, every tag of the account with its id, name, color, and projectCount, empty ones included; use these ids with manage_tags. tag lists only the projects in the tag with that exact name; an unknown name is NOT_FOUND. Tags are the dashboard's own labels for this account; collaborators do not see them.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_projects"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Exact name of a tag; only its projects are listed | |
| sort | No | lastUpdated is newest first; name is alphabetical | lastUpdated |
| limit | No | Maximum projects returned, at most 200 | |
| query | No | Case-insensitive substring of the project name | |
| includeTags | No | Add each project's tags and the account's tags; one more request to Overleaf | |
| includeTrashed | No | ||
| includeArchived | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | ||
| projects | Yes | ||
| totalMatched | Yes | ||
| totalProjects | Yes |