Foyer API pages

Foyer API

Connect Claude or ChatGPT

The Foyer connector lets Claude, ChatGPT and other assistants that support MCP (the Model Context Protocol) read your calls and voicemail when you ask. You sign in with your Foyer account and approve what the assistant may see. There is no key to copy.

On this page

What you can ask

Once connected, ask in your own words. For example:

The assistant answers from your Foyer account using the same endpoints as the REST API: your calls, voicemails, the review queue, search, contacts, numbers and settings.

Connect

The connector address: https://api.hifoyer.com/mcp

In Claude

Custom connector access depends on your plan and workspace permissions. A workspace administrator may need to enable it first.

  1. Open Settings › Connectors and add a custom connector.
  2. Name it "Foyer" and paste the connector address.
  3. Choose Connect. Foyer asks you to sign in.
  4. Approve what Claude may see. You can leave out recordings, or anything that changes settings.

In ChatGPT

Custom MCP apps require developer-mode support and may need workspace administrator approval. Menu names vary by client version.

  1. Open Settings › Apps and look for the custom app or connector option. If available, enable developer mode in the advanced settings.
  2. Create a custom app with the Foyer address and OAuth authentication. Leave optional client credentials empty for dynamic registration.
  3. Sign in with your Foyer account and approve only the permissions you need. Return to ChatGPT and enable Foyer for the conversation.

Other assistants: any client that supports remote MCP servers with OAuth sign-in can use the same address.

Check the connection

Ask “What voicemails did I get today?” Foyer should appear under Settings › Connected apps in Foyer after authorization. If access is refused, check account eligibility and the permissions before retrying; do not grant extra permissions just to clear an error. Menu names and custom-app support may differ by client version.

Permissions and safety

Once your calls reach Claude or ChatGPT, that service's own terms and privacy policy apply to them. See Privacy.

Without the connector

Assistants that run code, such as Claude Code, ChatGPT with code tools, or your own agent, can call the REST API directly with a key. Give the assistant the OpenAPI spec or llms-full.txt and a key from Settings › Connected apps, stored where the assistant can read it but you do not paste it into chats you share.