# `add_person_email`

Adds one address to an exact person in your private Rolodex. Existing addresses remain. This is an explicit additive action, separate from field-replacing [`update_person`](/docs/mcp/tools/update_person).

| Input | Required | Meaning |
| --- | --- | --- |
| `personId` | yes | Owned person ID resolved through List/Get. |
| `email` | yes | Valid email address, up to 254 characters; trimmed and lowercased. |

An address already on this person returns `already_exists` with `currentPerson`. An address assigned to another person rejects the operation. The action never removes addresses, moves ownership, merges people, changes profile statements, or sends mail.

Success returns the canonical Person directly, including the updated `etag` and its Gravity `link`. No etag is required because the addition is atomic and does not replace the address list. After an uncertain outcome, read [`get_person`](/docs/mcp/tools/get_person) before retrying. There is no original-result replay guarantee.

```json add_person_email
{
  "personId": "00000000-0000-4000-a000-000000000005",
  "email": "pat.work@example.test"
}
```

```json result:add_person_email
{
  "personId": "00000000-0000-4000-a000-000000000005",
  "displayName": "Synthetic Pat",
  "contactAuthoredName": "Synthetic Pat",
  "ownerAuthoredName": null,
  "emails": [
    "pat.work@example.test",
    "pat@example.test"
  ],
  "etag": "\"dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd\"",
  "authoredSummary": null,
  "linkedIn": {
    "url": null,
    "company": "Synthetic company",
    "position": "Designer"
  },
  "sections": {
    "general": [],
    "areasOfDepth": [],
    "currentWork": [
      {
        "statementId": "00000000-0000-4000-a000-000000000007",
        "text": "Building a synthetic product",
        "revision": 1,
        "scope": null,
        "uncertainty": null
      }
    ],
    "currentNeeds": [],
    "relationshipContext": [
      {
        "statementId": "00000000-0000-4000-a000-000000000008",
        "text": "You worked together",
        "revision": 1,
        "scope": null,
        "uncertainty": null
      }
    ]
  },
  "link": "https://www.meetgravity.ai/dashboard/rolodex?person=00000000-0000-4000-a000-000000000005"
}
```

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