Beam
Text us

Step by step, from Beam's developer docs

By · Updated

Connect Claude Code to iMessage

Connect Claude Code to iMessage through Beam by creating a workspace connection token and configuring the documented HTTP MCP connection. Start by checking the workspace, then review a draft and test sending with explicit permission.

This is Claude Code's MCP connection, not Claude's OAuth-only hosted web connector, which Beam does not support yet.

Choose the connection path

Beam provides MCP and OpenAPI access for authorized AI agents. Its developer documentation describes bearer-header HTTP and a local stdio bridge. Use the transport supported by your client, and keep connection tokens private.

CapabilityHow to use it
Claude CodeConnect through bearer-header HTTP using the Beam developer access instructions.
CodexUse the Beam documented MCP connection for Codex, with the token in the process environment.
Stdio clientsUse the documented local bridge when the client requires stdio.
Custom applicationReview the OpenAPI contract and API guide for a server-side integration.

Checked October 6, 2026. See Beam developer access for current client configuration.

Start with a workspace check

  1. Open Developer access in the intended Beam workspace and create a connection with the permissions you need.
  2. Store the token privately and configure the client using Beam's documented HTTP connection or stdio bridge.
  3. Ask the agent to identify the connected workspace without changing anything.
  4. Read a test conversation and review a draft before enabling sending.
  5. Grant send permission only for the intended workflow, then test with a contact you control on an active assigned line.

Read and train access are distinct from publishing, automation, sending and booking. A successful connection alone is not permission to send.

With BEAM_TOKEN set privately in your terminal environment, Beam documents this Claude Code connection command:

claude mcp add --transport http beam https://beam.aisync.link/mcp --header "Authorization: Bearer $BEAM_TOKEN"

Restart the client and verify the connected workspace before using sending tools. Follow Beam developer access for current setup details.

Move from a call or CRM event to a text

Use FaceTime Audio for business when the workflow starts with a call. Check two way CRM sync to keep the reply with the intended customer record.

For larger audiences, review outbound and mass texting before granting sending access. Budget, sending capacity and reply ownership still need a plan.

MCP and OpenAPI serve different integration needs

MCP exposes permissioned tools to a compatible agent client. OpenAPI describes the HTTP contract for an application integration. Beam supports both; choose based on where your workflow runs.

Read the Beam iMessage API guide for server-side messaging and signed events. A queued send is not a delivery receipt: check the recorded status and test-device result.

Before you connect

Setup and troubleshooting answers

Can an agent send a real iMessage through Beam?

Yes, with send permission and an active assigned line. Start with a test contact and check the delivery result separately from queue acceptance.

Does MCP access also configure FaceTime Audio?

MCP connects an agent to Beam workspace tools. Confirm FaceTime Audio routing separately with the Beam team before testing a call and follow-up.

Can I connect Codex as well as Claude?

Beam documents MCP connections for Claude Code and Codex. Follow the client-specific instructions in Beam developer access and keep the connection token private.

When should I use OpenAPI instead?

Use the OpenAPI contract when building a server-side HTTP integration. Use MCP when a compatible agent client should work through permissioned workspace tools.

What should I verify before sending?

Verify the connected workspace, permissions, intended recipient and assigned line. Review the message, send to a test contact and inspect the resulting conversation and delivery status.

Start with a conversation

Bring a test contact and try it live

Tell our team you want to connect Claude Code. We will walk through the token, the connection and a safe first test send.

Live sending requires a plan and an assigned dedicated line.

Interactive demo · Simulation
CCClearpath Coaching

iMessage
Today 9:41 AM

Hi! I would love to hear how your coaching works.

Happy to chat. Would Thursday work for a discovery call?

Thursday sounds great! Looking forward to meeting you.

Blue bubbles. Read receipts. Typing.

Type your own, or send a suggestion.

LET’S TALK

Want this for your business?

Try a conversation with the Beam team.

We use your number to prepare your text link and follow up. No spam. Privacy.

Beam is not affiliated with Anthropic or Apple.

Powered by Beam

Let's talk

Start a conversation.

Tell us a little about your business, or text our team directly.

Text us

(480) 486-1869