find-project-collaborators
Search for Todoist collaborators by name or email to find their user ID. Supports partial matches and can limit search to a specific project.
Instructions
Find Todoist users (collaborators, teammates) by name or email to look up their user ID. Use this whenever the user asks to find, look up, or identify a person — e.g. "find Carrie's user ID", "who is Ernesto", "look up a user". When projectId is omitted, searches across the collaborators of every shared project the authenticated user has access to, plus the authenticated user themselves — an empty result means the person is not a collaborator on any project you share with them, not necessarily that they do not exist in Todoist. When projectId is provided, searches only that project. Partial, case-insensitive match on name and email.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| projectId | No | Optional. If provided, searches only collaborators of this project. If omitted, searches across the collaborators of all shared projects the authenticated user can access (plus the authenticated user themselves) — use this for general "find a user" / "who is X" lookups. | |
| searchTerm | No | Search for a user by name or email (partial and case insensitive match). If omitted, all users are returned. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| totalCount | Yes | The total number of users found. | |
| projectInfo | No | Information about the project (only present when projectId was provided). | |
| collaborators | Yes | The found users. | |
| appliedFilters | Yes | The filters that were applied to the search. | |
| totalAvailable | No | The total number of available users before the search filter was applied. |