Help · How to
Connect Claude
Only a member of this workspace can pair Claude. Starlings has no self-serve workspace yet. The pairing signs in as that member, and Claude reads only what the member can read.
The public Starlings site publishes the help pages; use your workspace address for pairing, including /connect and /mcp.
- Add Starlings as a connector in Claude. Use the address
<your Starlings origin>/mcp. The client registers itself.- claude.ai or Claude Desktop: Settings → Connectors → Add custom connector.
- Claude Code: run
claude mcp add --transport http --scope user meet <your Starlings origin>/mcp, then open/mcpin aclaudesession, choose meet and Authenticate.
- The browser opens
/connect. Sign in as yourself. To let Claude write, tick Also write before you allow the pairing. Without it, Claude only reads. - Claude now has these tools:
search,open,now,transcript,schedule,start_meeting,send_message,task,create_issue,record_decision,ask_decision,set_goal,cms,docs_write. A read-only pairing lists only the read tools.ask_decisionputs a question in your decision queue when you are not in the conversation (a background or scheduled run); while you are talking with Claude it asks you there. You answer it from INBOX (Answer a decision).taskalso creates a lead: passaction: "create_lead"and a title, and Claude gets the lead's door and its channel, where Core posts New Lead Created. Claude can also set a lead's five qualification checks, on create or later withupdate_lead. Claude cannot delete a lead. Claude reads your Quick Notes throughnowand files one by passing its id asquick_notetotask,create_issue,send_messageordocs_write; the note is marked filed there, as File… does. Claude cannot delete a note. Claude can merge duplicate contacts or organizations in Core withcmsandmerge: Core keeps the oldest, moves everything from the others onto it, and records the merge; Claude names the survivor to you first. Claude also gets the resources and prompts, and an index of the product at/llms.txt. - When Starlings refuses a call, or the call fails, Claude gets the reason and a suggested next step. Claude can tell you both. A read-only pairing refuses every write. To allow writes, Revoke the pairing and pair again with Also write ticked.
- A message Claude sends with
send_messageis yours, and shows a quiet via claude.ai (or your client's name) beside the time, so the people reading it can tell. - Starlings records every call. See yours under Settings → Account → Connected Claudes, or all of them on Admin. Revoke ends the pairing.
- Pause stops a Claude at its next call and keeps the pairing. Starlings refuses each call and tells Claude that you paused it. Resume lets the next call through. You do not pair again.
Have a Claude start a meeting
Ask Claude to start a meeting. Claude calls start_meeting. This puts the meeting on the calendar, in your own room, and asks your devices to open the room.
Each of your running clients shows Open room or Not now. You have 45 seconds to answer, the same limit as a Wave. The room opens only when you choose Open room. If you do not answer, the meeting stays on the calendar and the room stays closed.
Starlings transcribes a room opened this way, because it is a convened meeting with a title and attendees. Starlings does not transcribe a room opened from a colleague's Call.
For an ordinary calendar event, use schedule. It does not ask your devices and does not open a room.
Where it works
| Capability | macOS Host | macOS Join | Web | iOS / iPadOS | Agent access |
|---|---|---|---|---|---|
| An agent starts a meetingHave | Not available | Not available | Not available | Not available | start_meeting (MCP), schedule (MCP), meetctl host |
| Projects and leads, with their tasks and issues | Works | Works | Works | Works | search (MCP), open (MCP), task (MCP), record_decision (MCP), set_goal (MCP), meet://subject/{kind}/{id}, meet://subjects/{kind}, meet://board/{days}, /api/crm/tasks, /api/crm/mine, /api/crm/recently-closed, /api/crm/unowned, /api/crm/goals, /api/crm/decisions, /api/crm/subjects, /api/crm/organizations |
| Create a meeting invitation from the owner workspace | Works | Works | Partial | Works | schedule (MCP) |
| Website content from a ClaudeHave | Not available | Not available | Not available | Not available | cms (MCP), meet://cms/registry, meet://core/registry |
Verified · docs/help/howto/connect-claude.md