List Users and Teams
list_users_and_teamsRead-onlyIdempotent
Fetch users and teams from Monday.com using specific IDs or name search. Retrieve current user info, team details, or filter by user or team IDs.
Instructions
Tool to fetch users and/or teams data.
MANDATORY BEST PRACTICES:
1. ALWAYS use specific IDs or names when available
2. If no ids available, use name search if possible (USERS ONLY)
3. Use 'getMe: true' to get current user information
4. AVOID broad queries (no parameters) - use only as last resort
REQUIRED PARAMETER PRIORITY (use in this order):
1. getMe - STANDALONE
2. userIds
3. name - STANDALONE (USERS ONLY, NOT for teams)
4. teamIds + teamsOnly
5. No parameters - LAST RESORT
CRITICAL USAGE RULES:
• userIds + teamIds requires explicit includeTeams: true flag
• includeTeams: true fetches both users and teams, do not use this to fetch a specific user's teams rather fetch that user by id and you will get their team memberships.
• name parameter is for USER search ONLY - it cannot be used to search for teams. Use teamIds to fetch specific teams.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| userIds | No | Specific user IDs to fetch.[IMPORTANT] ALWAYS use when you have user IDs in context. PREFER over general search. RETURNS: user profiles including team memberships | |
| teamIds | No | Specific team IDs to fetch.[IMPORTANT] ALWAYS use when you have team IDs in context, NEVER fetch all teams if specific IDs are available. RETURNS: Team details with owners and optional member data. | |
| name | No | Name-based USER search ONLY. STANDALONE parameter - cannot be combined with others. PREFERRED method for finding users when you know names. Performs fuzzy matching. CRITICAL: This parameter searches for USERS ONLY, NOT teams. To search for teams, use teamIds parameter instead. | |
| getMe | No | [TOP PRIORITY] Use ALWAYS when requesting current user information. Examples of when it should be used: ["get my user" or "get my teams"]. This parameter CONFLICTS with all others. | |
| includeTeams | No | [AVOID] This fetches all teams in the account. To fetch a specific user's teams just fetch that user by id and you will get their team memberships. | |
| teamsOnly | No | Fetch only teams, no users returned. Combine with includeTeamMembers for member details. | |
| includeTeamMembers | No | Set to true only when you need additional member details for teams other than names and ids. |