# invite_member (/docs/reference/mcp-tools/invite_member)



{/* Generated by apps/docs/scripts/generate-mcp-pages.mjs — do not edit by hand. */}

Invite a member by email or shareable link, with a pre-assigned role (Admin+).

|                     |                  |
| ------------------- | ---------------- |
| Required permission | `members:invite` |
| Capability ID       | `members.invite` |
| Destructive         | No               |

## Parameters [#parameters]

| Parameter        | Type                                                  | Required | Notes |
| ---------------- | ----------------------------------------------------- | -------- | ----- |
| `email`          | string \| null                                        | no       |       |
| `role`           | `OWNER` \| `ADMIN` \| `MEMBER` \| `GUEST` \| `VIEWER` | yes      |       |
| `workspaceId`    | string (uuid) \| null                                 | no       |       |
| `expiresInHours` | integer                                               | no       |       |

## Input schema (JSON Schema) [#input-schema-json-schema]

```json
{
  "type": "object",
  "properties": {
    "email": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "role": {
      "type": "string",
      "enum": [
        "OWNER",
        "ADMIN",
        "MEMBER",
        "GUEST",
        "VIEWER"
      ]
    },
    "workspaceId": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid"
        },
        {
          "type": "null"
        }
      ]
    },
    "expiresInHours": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8760,
      "default": 168
    }
  },
  "required": [
    "role"
  ],
  "additionalProperties": false
}
```

## Access control [#access-control]

A call succeeds only when the personal access token's scopes **and** the holder's role both allow `members:invite` (effective permission = scope ∩ role, default-deny). The tool runs inside the token owner's organization — tenancy is never a parameter.