List, inspect, create, and update people records

Use list_people for bounded summaries and get_person only after the user selects a record. Use create_person or update_person only for an explicit request. New MCP-created records are private by default, creation requires an idempotency key, and contact details, notes, linked-account identity, and embedded chart payloads are excluded from tool responses.

Request and response shapes

Input shape

{ query?: string; limit?: number } | { personId: string } | { idempotencyKey: string; name: string; birth fields... } | { personId: string; patch: PersonPatch }

Output shape

{ people: PersonSummary[] } | { person: SafePerson } | { person: SafePerson; created: boolean }

Examples

Request example

{
  "idempotencyKey": "person-ada-2026-07-19",
  "name": "Ada",
  "birthDate": "1990-01-15"
}

Response example

{
  "person": {
    "id": "mcp_person_example",
    "name": "Ada"
  },
  "created": true
}

Common validation errors

People tools require people:read or people:write and ownership is checked server-side.
create_person requires an idempotency key of at least 16 characters.
create_person respects the connected account's people-record quota.

List, inspect, create, and update people records

Request and response shapes

Input shape

{ query?: string; limit?: number } | { personId: string } | { idempotencyKey: string; name: string; birth fields... } | { personId: string; patch: PersonPatch }

Output shape

{ people: PersonSummary[] } | { person: SafePerson } | { person: SafePerson; created: boolean }

Examples

Request example

{
  "idempotencyKey": "person-ada-2026-07-19",
  "name": "Ada",
  "birthDate": "1990-01-15"
}

Response example

{
  "person": {
    "id": "mcp_person_example",
    "name": "Ada"
  },
  "created": true
}

Common validation errors

People tools require people:read or people:write and ownership is checked server-side.
create_person requires an idempotency key of at least 16 characters.
create_person respects the connected account's people-record quota.

List, inspect, create, and update people records

Request and response shapes

Input shape

Output shape

Examples

Request example

Response example

Common validation errors

Related questions

List, inspect, create, and update people records

Request and response shapes

Input shape

Output shape

Examples

Request example

Response example

Common validation errors

Related questions