Use this tool to look up users or teams by ID, name, or relationship to the current user. The response includes user profiles (name, title, admin status, team memberships) and team details (name, owners, optional member lists). You can target a specific user by ID, search by name, get information about the current user, or list specific teams.

🚧
MANDATORY BEST PRACTICES — always follow this parameter priority order:

getMe — use whenever the request refers to the current user. This parameter is standalone and conflicts with all others.

userIds — use whenever you have specific user IDs in context. Preferred over name search.

name — use for fuzzy name matching on users only. This is a standalone parameter and cannot be combined with others. Do not use name to search for teams — use teamIds instead.

teamIds + teamsOnly — use when you have specific team IDs. Never fetch all teams if specific IDs are available.

No parameters — last resort only. Avoid broad queries that return the full user/team list.

Parameters

Parameter	Type	Required	Description
getMe	`boolean`	No	Returns the current user's profile including team memberships. Top priority — use whenever the request refers to "me" or "my teams". Conflicts with all other parameters.
userIds	`array`	No	Array of specific user IDs to fetch (max 500). Always use when user IDs are available in context. Returns user profiles including team memberships.
name	`string`	No	Fuzzy name search for users only. Standalone — cannot be combined with other parameters. Do not use to search for teams.
teamIds	`array`	No	Array of specific team IDs to fetch (max 500). Always use when team IDs are known. Returns team details with owners and optional member data.
includeTeams	`boolean`	No	Fetches all teams in the account alongside users. Avoid — only use as a last resort. To get a specific user's teams, fetch that user by `userIds` instead.
teamsOnly	`boolean`	No	Returns only teams, no users. Combine with `teamIds` for targeted team lookup, or with `includeTeamMembers` for full member details.
includeTeamMembers	`boolean`	No	Set to `true` only when you need full member details for teams beyond names and IDs.

Example

Get the current user:

{
  "getMe": true
}

The tool returned the current user's ID (48202303), name (Daniel Hai), title (Product Manager), and flags for admin and guest status.

Look up specific users by ID:

{
  "userIds": ["48202303", "66347492"]
}

Search for a user by name:

{
  "name": "Daniel"
}

Fetch specific teams:

{
  "teamIds": ["12345", "67890"],
  "teamsOnly": true
}

Programmatic equivalent

Use the GraphQL API to achieve the same result:

query {
  users(ids: [48202303]) {
    id
    name
    title
    email
    is_admin
    is_guest
    enabled
    teams {
      id
      name
    }
  }
}

To fetch teams, use the teams query:

query {
  teams(ids: [12345]) {
    id
    name
    picture_url
    owners {
      id
      name
    }
    users {
      id
      name
    }
  }
}

For full documentation, see Users and Teams.