Skip to content

get_me

get_me

Return the user the OAuth token belongs to, the team the token is bound to, and the user’s role in that team. Useful at session start so the agent can greet the user by name and pick the right team-aware behavior.

No fields.

{}

A single text content block containing a JSON object with the caller’s identity.

FieldTypeDescription
user.idstringUser ID of the OAuth token’s owner.
user.namestringDisplay name.
user.emailstringEmail address.
user.imagestring | nullAvatar URL, or null if not set.
organization.idstringID of the team the token is bound to.
organization.namestringTeam name.
organization.rolestringThe caller’s role in the team (e.g. owner, admin, member).
{
  "user": {
    "id": "u_abc123",
    "name": "Alex Kim",
    "email": "alex@acme.com",
    "image": "https://cdn.orsane.app/avatars/u_abc123.png"
  },
  "organization": {
    "id": "org_xyz",
    "name": "Acme Inc.",
    "role": "admin"
  }
}

The tool returns isError: true with an explanatory text block when the token’s user is no longer a member of the bound team.