# Get Directory Contact

`ringcentral_get-directory-contact` · RingCentral MCP tool · Identity

Fetch contact information for a single corporate user in the RingCentral account's company directory by directory entry (extension) ID.

## RingCentral Frequently Asked Questions

**What does the Get Directory Contact tool do?**

This page documents the Get Directory Contact tool (`ringcentral_get-directory-contact`). Fetch contact information for a single corporate user in the RingCentral account's company directory by directory entry (extension) ID. It is one of the RingCentral Identity tools, invoked through your firm's Weave MCP connection and available to members whose access level permits it.

**What is the RingCentral integration?**

The RingCentral integration connects your firm's RingCentral account to Weave. RingCentral (RingEX) is a cloud phone/UCaaS platform. This integration exposes read-only call log, call analytics, recordings, directory, extension, and account diagnostics data as governed MCP tools, scoped per member by access level. It groups 17 tools into 5 categories, exposed through your firm's Weave MCP connection and filtered per member by access level.

## Input

- **id** `string` (required, min length: 1) — Internal identifier of the directory entry (extension) to fetch.

## Output

- **id** `string` (required) — Contact extension identifier.
- **type** `string` — Contact type (open string — RC directory contact-type taxonomy; may return values beyond the vendored enum).
- **status** `string` (enum: "Enabled", "Disabled", "Frozen", "NotActivated", "Unassigned", "Unknown") — Contact status.
- **account** `object` — The account this contact belongs to.
  - **companyName** `string` — Company name of the account.
  - **federatedName** `string` — Federated (holding) company name, if federated.
  - **id** `string` (required) — Internal identifier of the account.
  - **mainNumber** `object` — Account main phone number.
    - **formattedPhoneNumber** `string` — Human-formatted phone number.
    - **phoneNumber** `string` — Phone number in E.164-like form.
    - **type** `string` — Phone number type (documented example 'VoiceFax'; open string, not a closed enum).
    - **label** `string` — Custom user-assigned name of the phone number, if any.
    - **usageType** `string` (enum: "MobileNumber", "ContactNumber", "DirectNumber", "ForwardedNumber") — Usage type of the phone number.
    - **hidden** `boolean` — Whether the phone number should be hidden.
    - **primary** `boolean` — Whether this is the primary number (displayed as 'main number', called by default).
    - **smsAvailabilityStatus** `string` — SMS availability status of the phone number (live-observed, undocumented field).
- **department** `string` — Department name, when applicable.
- **email** `string` — Contact email address.
- **extensionNumber** `string` — Extension short number.
- **firstName** `string` — First name, for user extensions only.
- **lastName** `string` — Last name, for user extensions only.
- **name** `string` — Name, for non-user extensions.
- **jobTitle** `string` — Job title.
- **phoneNumbers** `array` — Phone numbers associated with the contact.
  - **[]** `object`
    - **formattedPhoneNumber** `string` — Human-formatted phone number.
    - **phoneNumber** `string` — Phone number in E.164-like form.
    - **type** `string` — Phone number type (documented example 'VoiceFax'; open string, not a closed enum).
    - **label** `string` — Custom user-assigned name of the phone number, if any.
    - **usageType** `string` (enum: "MobileNumber", "ContactNumber", "DirectNumber", "ForwardedNumber") — Usage type of the phone number.
    - **hidden** `boolean` — Whether the phone number should be hidden.
    - **primary** `boolean` — Whether this is the primary number (displayed as 'main number', called by default).
    - **smsAvailabilityStatus** `string` — SMS availability status of the phone number (live-observed, undocumented field).
- **profileImage** `object` — Contact profile image.
  - **etag** `string` — Identifier of the profile image.
  - **uri** `string` — Link to the profile image resource.
- **site** `object` — Business site the contact belongs to.
  - **id** `string` — Internal identifier of the business site.
  - **name** `string` — Name of the business site.
  - **code** `string` — Site code value.
- **hidden** `boolean` — Whether the contact is hidden from the directory.
- **role** `object` — Directory role assigned to the contact.
  - **id** `string` (required) — Internal identifier of the directory role.
  - **name** `string` — Name of the role.
  - **domain** `string` — Domain the role applies to.
  - **displayName** `string` — Display name of the role.
- **callQueues** `array` — Call queues the contact belongs to.
  - **[]** `object`
    - **id** `string` — Internal identifier of the call queue.
    - **name** `string` — Name of the call queue.
- **customFields** `array` — Custom field values on the contact.
  - **[]** `object`
    - **id** `string` — Internal identifier of the custom field.
    - **name** `string` — Name of the custom field.
    - **value** `string` — Value of the custom field.
- **groups** `array` — Groups the contact belongs to.
  - **[]** `object`
    - **id** `string` — Internal identifier of the group.
    - **name** `string` — Name of the group.
- **costCenter** `object` — Cost center assigned to the contact.
  - **id** `string` — Internal identifier of the cost center.
  - **code** `string` — Cost center code.
  - **name** `string` — Name of the cost center.
- **integration** `object` — External integration information, when applicable.
  - **id** `string` — Internal identifier of the external integration.
  - **typeId** `string` — Internal identifier of the integration type.
  - **type** `string` — Integration type.
  - **displayName** `string` — Display name of the integration.
  - **routingType** `string` — Routing type used by the integration.
  - **outboundEdgeId** `string` — Outbound edge identifier used by the integration.
- **subType** `string` (enum: "Unknown", "VideoPro", "VideoProPlus", "DigitalSignage", "Emergency") — Contact subtype, when applicable.