# `create_person`

Creates one person in your private Rolodex. Resolve identity with [`list_people`](/docs/mcp/tools/list_people) first. A first name is sufficient. This operation never silently updates an existing person.

| Input | Required | Meaning |
| --- | --- | --- |
| `person` | yes | Resource fields described below. |
| `person.ownerAuthoredName` | yes | Your private label, 1–120 characters. |
| `person.emails` | no | Up to 20 initial addresses, normalized and deduplicated. |
| `person.linkedIn` | no | Supplied `url`, `company`, and `position`. |

After creating the person, use their ID with [`add_notes`](/docs/mcp/tools/add_notes) to provide profile context such as how you know them.

An email already owned in your Rolodex, or an existing displayed name when no email is supplied, rejects with `already_exists` and `currentPerson`. Review that person before an explicit [`update_person`](/docs/mcp/tools/update_person). For a different person with the same name, use an email or distinguishing name. No merge is performed.

Success returns the canonical Person directly, with the same fields as [`get_person`](/docs/mcp/tools/get_person), including its quoted opaque `etag`. MCP adds the exact Gravity `link`. There is no `state`, `created`, or `changedFields` wrapper. After an uncertain response, read current people before retrying; there is no general request replay key.

```json create_person
{
  "person": {
    "ownerAuthoredName": "Synthetic Pat",
    "emails": [
      "pat@example.test"
    ]
  }
}
```

```json result:create_person
{
  "personId": "00000000-0000-4000-a000-000000000005",
  "displayName": "Synthetic Pat",
  "contactAuthoredName": null,
  "ownerAuthoredName": "Synthetic Pat",
  "emails": [
    "pat@example.test"
  ],
  "etag": "\"cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc\"",
  "authoredSummary": null,
  "linkedIn": null,
  "sections": {
    "general": [],
    "areasOfDepth": [],
    "currentWork": [],
    "currentNeeds": [],
    "relationshipContext": []
  },
  "link": "https://www.meetgravity.ai/dashboard/rolodex?person=00000000-0000-4000-a000-000000000005"
}
```

Annotations: `readOnlyHint: false` · `destructiveHint: false` · `idempotentHint: false` · `openWorldHint: false`
