MCP Server

openphone

io.usefulapi/openphone
Communication Sales & CRM Public & reachable MCP 2026-07-28

What this MCP does

Reads and sends OpenPhone texts, calls and recordings while managing contacts, conversations, phone numbers and workspace users.

openphone_create_contact
Create a contact
Create a new contact in the workspace. WRITE ACTION — this adds a persistent contact record. Emails and phoneNumbers are passed as simple string arrays and stored under default field labels. OpenPhone REST: POST /contacts.
Destructive
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['firstName'], 'properties': {'role': {'type': 'string', 'description': "The contact's role / job title."}, 'emails': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Email addresses for the contact.'}, 'source': {'type': 'string', 'description': "How the contact was created; defaults to 'public-api'."}, 'company': {'type': 'string', 'description': "The contact's company."}, 'lastName': {'type': 'string', 'description': "The contact's last name."}, 'firstName': {'type': 'string', 'minLength': 1, 'description': "The contact's first name (required)."}, 'sourceUrl': {'type': 'string', 'format': 'uri', 'description': 'A link to the contact in the source system.'}, 'externalId': {'type': 'string', 'maxLength': 75, 'minLength': 1, 'description': 'A unique id from an external system (1-75 chars).'}, 'phoneNumbers': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Phone numbers for the contact (E.164 recommended).'}}}
openphone_get_call
Get a call
Get a single call by its id (starts with 'AC') — direction, status, duration, participants and timestamps. OpenPhone REST: GET /calls/{id}.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': "The call id (starts with 'AC')."}}}
openphone_get_call_recordings
Get call recordings
Get the recordings for a call by its id — each with a URL, duration, start time and status. OpenPhone REST: GET /call-recordings/{callId}.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['callId'], 'properties': {'callId': {'type': 'string', 'minLength': 1, 'description': "The call id (starts with 'AC')."}}}
openphone_get_call_summary
Get a call summary
Get the AI-generated summary and next steps for a call by its id. Availability depends on your plan and whether the call was summarized. OpenPhone REST: GET /call-summaries/{callId}.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['callId'], 'properties': {'callId': {'type': 'string', 'minLength': 1, 'description': "The call id (starts with 'AC')."}}}
openphone_get_call_transcript
Get a call transcript
Get the transcription for a call by its id — dialogue segments with speaker, text and timestamps, plus overall status and duration. OpenPhone REST: GET /call-transcripts/{id}.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': "The call id (starts with 'AC')."}}}
openphone_get_contact
Get a contact
Get a single contact by its id, including default fields (name, company, role, emails, phone numbers) and custom fields. OpenPhone REST: GET /contacts/{id}.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'The contact id.'}}}
openphone_get_contact_custom_fields
Get contact custom fields
List the workspace's contact custom-field definitions (name, key, type). Use the returned keys when creating contacts with custom fields. OpenPhone REST: GET /contact-custom-fields.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
openphone_get_message
Get a message
Get a single message by its id (starts with 'AC'). OpenPhone REST: GET /messages/{id}.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': "The message id (starts with 'AC')."}}}
openphone_list_calls
List calls
List calls between one of your OpenPhone numbers and a participant, newest first, optionally filtered by user and created date range. Returns direction, status, duration and timestamps. OpenPhone REST: GET /calls.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['phoneNumberId', 'participants'], 'properties': {'userId': {'type': 'string', 'description': "Scope results to a user's access (a user id starting with 'US'). From openphone_list_users."}, 'pageToken': {'type': 'string', 'description': "Pagination token from a previous response's nextPageToken."}, 'maxResults': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Results per page, 1-100. Default 10.'}, 'createdAfter': {'type': 'string', 'description': "Only calls created after as an ISO-8601 datetime, e.g. '2026-07-01T00:00:00Z'."}, 'participants': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 1, 'minItems': 1, 'description': "A single participant phone number in E.164 format, e.g. '+15555555555' (required, exactly 1)."}, 'createdBefore': {'type': 'string', 'description': "Only calls created before as an ISO-8601 datetime, e.g. '2026-07-01T00:00:00Z'."}, 'phoneNumberId': {'type': 'string', 'minLength': 1, 'description': "An OpenPhone phone-number id (starts with 'PN'). Get it from openphone_list_phone_numbers."}}}
openphone_list_contacts
List contacts
List contacts in the workspace, optionally filtered by external ids or sources. Returns each contact's default fields (name, company, emails, phone numbers) and custom fields. OpenPhone REST: GET /contacts.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'sources': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Filter to contacts created by these sources.'}, 'pageToken': {'type': 'string', 'description': "Pagination token from a previous response's nextPageToken."}, 'maxResults': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Results per page, 1-50. Default 10.'}, 'externalIds': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Filter to contacts with these external ids (from an integrated system).'}}}
openphone_list_conversations
List conversations
List conversations (threads), most-recent activity first, optionally filtered by phone number(s), user, and created/updated date ranges. Each conversation has participants, assignee, and last-activity metadata. OpenPhone REST: GET /conversations.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['maxResults'], 'properties': {'userId': {'type': 'string', 'description': "Scope results to a user's access (a user id starting with 'US'). From openphone_list_users."}, 'pageToken': {'type': 'string', 'description': "Pagination token from a previous response's nextPageToken."}, 'maxResults': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Results per page, 1-100 (required).'}, 'createdAfter': {'type': 'string', 'description': "Only conversations created after as an ISO-8601 datetime, e.g. '2026-07-01T00:00:00Z'."}, 'phoneNumbers': {'type': 'array', 'items': {'type': 'string'}, 'description': "Filter to conversations on these OpenPhone numbers (E.164 or 'PN...' ids), 1-100 items."}, 'updatedAfter': {'type': 'string', 'description': "Only conversations updated after as an ISO-8601 datetime, e.g. '2026-07-01T00:00:00Z'."}, 'createdBefore': {'type': 'string', 'description': "Only conversations created before as an ISO-8601 datetime, e.g. '2026-07-01T00:00:00Z'."}, 'updatedBefore': {'type': 'string', 'description': "Only conversations updated before as an ISO-8601 datetime, e.g. '2026-07-01T00:00:00Z'."}, 'excludeInactive': {'type': 'boolean', 'description': 'Exclude inactive conversations when true.'}}}
openphone_list_messages
List messages
List messages in a conversation between one of your OpenPhone numbers and one or more participants. Returns text, direction, status and timestamps. OpenPhone REST: GET /messages.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['phoneNumberId', 'participants'], 'properties': {'userId': {'type': 'string', 'description': "Scope results to a user's access (a user id starting with 'US'). From openphone_list_users."}, 'pageToken': {'type': 'string', 'description': "Pagination token from a previous response's nextPageToken."}, 'maxResults': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Results per page, 1-100. Default 10.'}, 'createdAfter': {'type': 'string', 'description': "Only messages created after as an ISO-8601 datetime, e.g. '2026-07-01T00:00:00Z'."}, 'participants': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 10, 'minItems': 1, 'description': "Participant phone numbers in E.164 format (e.g. '+15555555555'), 1-10 items (required)."}, 'createdBefore': {'type': 'string', 'description': "Only messages created before as an ISO-8601 datetime, e.g. '2026-07-01T00:00:00Z'."}, 'phoneNumberId': {'type': 'string', 'minLength': 1, 'description': "An OpenPhone phone-number id (starts with 'PN'). Get it from openphone_list_phone_numbers."}}}
openphone_list_phone_numbers
List phone numbers
List the OpenPhone numbers in the workspace (id, number, name, formatted number, assigned users, restrictions). Usually the first call — most other tools need a phoneNumberId. OpenPhone REST: GET /phone-numbers.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'userId': {'type': 'string', 'description': "Scope results to a user's access (a user id starting with 'US'). From openphone_list_users."}}}
openphone_list_users
List users
List workspace users (id, email, name, role). Use to find a userId for scoping other calls. OpenPhone REST: GET /users.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'pageToken': {'type': 'string', 'description': "Pagination token from a previous response's nextPageToken."}, 'maxResults': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Results per page, 1-50. Default 10.'}}}
openphone_list_webhooks
List webhooks
List all webhooks configured in the workspace (id, url, events, status). Read-only inventory — this tool does not create or delete webhooks. OpenPhone REST: GET /webhooks.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
openphone_send_message
Send a text message
Send an SMS/text message from one of your OpenPhone numbers to up to 10 recipients. WRITE ACTION — this actually sends a real text message (which may incur carrier cost and requires approved A2P 10DLC registration). OpenPhone REST: POST /messages.
Destructive
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['content', 'from', 'to'], 'properties': {'to': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 10, 'minItems': 1, 'description': 'Recipients in E.164 format (or contact ids), 1-10 items (required).'}, 'from': {'type': 'string', 'minLength': 1, 'description': "The sending OpenPhone number — a phone-number id ('PN...') or E.164 number, e.g. '+15555555555' (required)."}, 'userId': {'type': 'string', 'description': "The sending user id ('US...'); defaults to the phone number's owner."}, 'content': {'type': 'string', 'maxLength': 1600, 'minLength': 1, 'description': 'The message body, 1-1600 characters (required).'}, 'setInboxStatus': {'enum': ['done'], 'type': 'string', 'description': "Set to 'done' to mark the conversation complete after sending."}}}
Added
openphone_create_contact
Oct. 4, 2026, 2:40 a.m.
Added
openphone_list_webhooks
Oct. 4, 2026, 2:40 a.m.
Added
openphone_get_call_recordings
Oct. 4, 2026, 2:40 a.m.
Added
openphone_get_call_transcript
Oct. 4, 2026, 2:40 a.m.
Added
openphone_get_call_summary
Oct. 4, 2026, 2:40 a.m.
Added
openphone_get_call
Oct. 4, 2026, 2:40 a.m.
Added
openphone_list_calls
Oct. 4, 2026, 2:40 a.m.
Added
openphone_send_message
Oct. 4, 2026, 2:40 a.m.
Added
openphone_get_message
Oct. 4, 2026, 2:40 a.m.
Added
openphone_list_messages
Oct. 4, 2026, 2:40 a.m.
Added
openphone_list_conversations
Oct. 4, 2026, 2:40 a.m.
Added
openphone_get_contact_custom_fields
Oct. 4, 2026, 2:40 a.m.
Added
openphone_get_contact
Oct. 4, 2026, 2:40 a.m.
Added
openphone_list_contacts
Oct. 4, 2026, 2:40 a.m.
Added
openphone_list_users
Oct. 4, 2026, 2:40 a.m.
Added
openphone_list_phone_numbers
Oct. 4, 2026, 2:40 a.m.