# Starlings > Meetings, calendar, work and team in one workspace, on Mac, iOS and the web. A member’s own agent (Claude, Hermes or any MCP client) reaches it over MCP at `/mcp`, acting as that member. ## Surfaces - [surfaces/admin](https://hq.starlings.work/help/surfaces/admin): Admin: the org in six groups with a page per topic, opening on People; admins only ([markdown](https://hq.starlings.work/help/surfaces/admin.md)) - [surfaces/calendar](https://hq.starlings.work/help/surfaces/calendar): Calendar: Google, EventKit and subscriptions, one week or day or month; ⌘2; `/calendar` ([markdown](https://hq.starlings.work/help/surfaces/calendar.md)) - [surfaces/docs](https://hq.starlings.work/help/surfaces/docs): Docs: the whole corpus, with a linked graph view; save links and articles from iOS, Mac and the browser; ⌘5; `/docs` ([markdown](https://hq.starlings.work/help/surfaces/docs.md)) - [surfaces/ended](https://hq.starlings.work/help/surfaces/ended): Ended: the meeting is over, how long it lasted, why it ended ([markdown](https://hq.starlings.work/help/surfaces/ended.md)) - [surfaces/home](https://hq.starlings.work/help/surfaces/home): Home: the clock, the modules in your order, and your room. ⌘1; the first tab; `/` ([markdown](https://hq.starlings.work/help/surfaces/home.md)) - [surfaces/meeting](https://hq.starlings.work/help/surfaces/meeting): Meeting: the stage, the rail and the control row while a call is live ([markdown](https://hq.starlings.work/help/surfaces/meeting.md)) - [surfaces/prejoin](https://hq.starlings.work/help/surfaces/prejoin): Prejoin: before you join, the camera and microphone check, then Ask to join ([markdown](https://hq.starlings.work/help/surfaces/prejoin.md)) - [surfaces/room-entry](https://hq.starlings.work/help/surfaces/room-entry): Room entry: a guest at `/room/`, with a name, an email and two doors ([markdown](https://hq.starlings.work/help/surfaces/room-entry.md)) - [surfaces/schedule](https://hq.starlings.work/help/surfaces/schedule): Schedule: `/book/`, pick a time, say who you are ([markdown](https://hq.starlings.work/help/surfaces/schedule.md)) - [surfaces/search](https://hq.starlings.work/help/surfaces/search): Search: the ⌘K palette, one box that finds anything and jumps anywhere ([markdown](https://hq.starlings.work/help/surfaces/search.md)) - [surfaces/settings](https://hq.starlings.work/help/surfaces/settings): Settings: account, room policy, calendar, audio, video, captions, Home layout, Inbox sources, language; ⌘,; `/settings` ([markdown](https://hq.starlings.work/help/surfaces/settings.md)) - [surfaces/team](https://hq.starlings.work/help/surfaces/team): Team: who in the workspace is around, and reaching them; ⌘4; `/team` ([markdown](https://hq.starlings.work/help/surfaces/team.md)) - [surfaces/waiting-room](https://hq.starlings.work/help/surfaces/waiting-room): Waiting room: the knock is sent; the host decides ([markdown](https://hq.starlings.work/help/surfaces/waiting-room.md)) - [surfaces/work](https://hq.starlings.work/help/surfaces/work): Work: every subject, what needs you, what you owe; ⌘3; `/work` ([markdown](https://hq.starlings.work/help/surfaces/work.md)) ## How-to - [howto/answer-a-calendar-invitation](https://hq.starlings.work/help/howto/answer-a-calendar-invitation): Accept, Maybe or Decline a Google Calendar invitation from the Inbox on Mac, iPhone and web ([markdown](https://hq.starlings.work/help/howto/answer-a-calendar-invitation.md)) - [howto/answer-a-decision](https://hq.starlings.work/help/howto/answer-a-decision): Answer the decisions an agent put to you, from INBOX on any client; how an agent asks and reads the answer ([markdown](https://hq.starlings.work/help/howto/answer-a-decision.md)) - [howto/answer-a-question](https://hq.starlings.work/help/howto/answer-a-question): Answer or dismiss an assigned agent question from Home or Work Inbox on Mac, iOS and web ([markdown](https://hq.starlings.work/help/howto/answer-a-question.md)) - [howto/book-a-time](https://hq.starlings.work/help/howto/book-a-time): Find a time with a member at `/book/` ([markdown](https://hq.starlings.work/help/howto/book-a-time.md)) - [howto/call-a-colleague](https://hq.starlings.work/help/howto/call-a-colleague): Wave for attention, or Call into their room ([markdown](https://hq.starlings.work/help/howto/call-a-colleague.md)) - [howto/connect-a-repository](https://hq.starlings.work/help/howto/connect-a-repository): Map a GitHub repository to a project at `/admin/connectors/github` ([markdown](https://hq.starlings.work/help/howto/connect-a-repository.md)) - [howto/connect-an-agent-as-a-team-member](https://hq.starlings.work/help/howto/connect-an-agent-as-a-team-member): Put any agent runtime in a workspace's Team: it enrolls itself, an admin approves the code, it collects its own keys ([markdown](https://hq.starlings.work/help/howto/connect-an-agent-as-a-team-member.md)) - [howto/connect-an-agent-over-mcp](https://hq.starlings.work/help/howto/connect-an-agent-over-mcp): Pair any MCP client (Claude, Hermes or your own agent) with Starlings at `/mcp`, acting as you ([markdown](https://hq.starlings.work/help/howto/connect-an-agent-over-mcp.md)) - [howto/connect-claude](https://hq.starlings.work/help/howto/connect-claude): Pair a Claude with Starlings over MCP at `/connect` ([markdown](https://hq.starlings.work/help/howto/connect-claude.md)) - [howto/file-a-task-on-github](https://hq.starlings.work/help/howto/file-a-task-on-github): Turn a task into an issue on the subject's repository ([markdown](https://hq.starlings.work/help/howto/file-a-task-on-github.md)) - [howto/forward-an-email](https://hq.starlings.work/help/howto/forward-an-email): Forward an email into a project's channel, or to calendar@ to add the events it describes, from any mail app ([markdown](https://hq.starlings.work/help/howto/forward-an-email.md)) - [howto/hand-off-a-card-to-an-agent](https://hq.starlings.work/help/howto/hand-off-a-card-to-an-agent): Give a task or an issue to an agent from Work ([markdown](https://hq.starlings.work/help/howto/hand-off-a-card-to-an-agent.md)) - [howto/host-a-meeting](https://hq.starlings.work/help/howto/host-a-meeting): Open your room, admit who knocks, end it; from the Mac, the phone, or the CLI ([markdown](https://hq.starlings.work/help/howto/host-a-meeting.md)) - [howto/join-a-room](https://hq.starlings.work/help/howto/join-a-room): Enter a room as a guest: the link, your name and email, the check, the knock ([markdown](https://hq.starlings.work/help/howto/join-a-room.md)) - [howto/labels-the-board-reads](https://hq.starlings.work/help/howto/labels-the-board-reads): Which GitHub labels move a card on the Work board, and which are inert ([markdown](https://hq.starlings.work/help/howto/labels-the-board-reads.md)) - [howto/message-a-colleague](https://hq.starlings.work/help/howto/message-a-colleague): Send a message, start a group, or reach Everyone from Team ([markdown](https://hq.starlings.work/help/howto/message-a-colleague.md)) - [howto/read-a-meeting-transcript](https://hq.starlings.work/help/howto/read-a-meeting-transcript): Find the transcript and notes of a meeting that ended ([markdown](https://hq.starlings.work/help/howto/read-a-meeting-transcript.md)) - [howto/read-project-status](https://hq.starlings.work/help/howto/read-project-status): Have an agent answer where a project stands: which read to make, the six stage words, and what a status is not ([markdown](https://hq.starlings.work/help/howto/read-project-status.md)) - [howto/remove-a-channel-without-a-subject](https://hq.starlings.work/help/howto/remove-a-channel-without-a-subject): Remove a channel whose project, lead, partner or event was deleted from the workspace, and put it back (admins) ([markdown](https://hq.starlings.work/help/howto/remove-a-channel-without-a-subject.md)) - [howto/run-an-event-sign-up](https://hq.starlings.work/help/howto/run-an-event-sign-up): Let people sign up for an event at `/event/`, let them in with their own link, and send the follow-up ([markdown](https://hq.starlings.work/help/howto/run-an-event-sign-up.md)) - [howto/save-a-page-from-your-browser](https://hq.starlings.work/help/howto/save-a-page-from-your-browser): Save any web page to Docs from your browser or from Safari on iPhone, article included ([markdown](https://hq.starlings.work/help/howto/save-a-page-from-your-browser.md)) - [howto/send-a-follow-up-after-a-call](https://hq.starlings.work/help/howto/send-a-follow-up-after-a-call): After a call with people from outside your team, approve the drafted follow-up and its tasks from Inbox; your mail app sends it ([markdown](https://hq.starlings.work/help/howto/send-a-follow-up-after-a-call.md)) - [howto/set-up-pipelines](https://hq.starlings.work/help/howto/set-up-pipelines): Name your records and set up the pipelines a lead or a project moves through, with each stage's checklist, tasks on entry and required fields, in Admin › Pipelines ([markdown](https://hq.starlings.work/help/howto/set-up-pipelines.md)) - [howto/set-up-your-workspace](https://hq.starlings.work/help/howto/set-up-your-workspace): Set up a new workspace as its first admin: the steps on Home, on the Mac, iPhone and web, and what ticks each one ([markdown](https://hq.starlings.work/help/howto/set-up-your-workspace.md)) - [howto/switch-workspaces](https://hq.starlings.work/help/howto/switch-workspaces): Sign in from the list of your workspaces, add one by its address, switch, and sign out of or remove one on the Mac, iPhone or web ([markdown](https://hq.starlings.work/help/howto/switch-workspaces.md)) - [howto/use-a-project-board](https://hq.starlings.work/help/howto/use-a-project-board): See a project's tasks and issues by stage, move them, filter them, and hide the columns you do not use ([markdown](https://hq.starlings.work/help/howto/use-a-project-board.md)) - [howto/write-an-offer](https://hq.starlings.work/help/howto/write-an-offer): Write an offer on a lead or an organization, send it, change it after sending, and record the buyer's answer ([markdown](https://hq.starlings.work/help/howto/write-an-offer.md)) ## Glossary - [glossary](https://hq.starlings.work/help/glossary): what each word means in Starlings, with its source ## Capabilities - [features/status](https://hq.starlings.work/workspace/status): every capability, where it works, and the door an agent has into it; the same rows are in llms-full.txt ## Agent access - MCP endpoint: https://hq.starlings.work/mcp - Workspace descriptor: https://hq.starlings.work/.well-known/starlings (name, hosts, sign-in domains, brand) - Pairing: Any MCP client that does OAuth 2.1 with dynamic client registration and PKCE pairs as the member who allows it. Only a member of this workspace can pair one. Starlings has no self-serve workspace yet. [How to connect an agent over MCP](https://hq.starlings.work/help/howto/connect-an-agent-over-mcp); [How to connect Claude](https://hq.starlings.work/help/howto/connect-claude). - OpenAPI 3.1: https://hq.starlings.work/openapi.json (the internal routes wrapped by MCP) - Door grammar: things use `subject::`, `person:`, `agent:`, `thread:`, `document:`, `event:`, `task:`, `issue:/#` or `core:`; places use `destination:`, `settings:` or `verb:`. `open` accepts thing doors only. - Agents never enter a room or read live meetings; they can read finalized artifacts after a meeting ends. Every MCP call is recorded. ### MCP tools - search: Search everything the signed-in member can see in Starlings: subjects (leads, projects, organizations, events), people, agents, contacts (people outside the workspace), conversations, documents, calendar events, tasks and GitHub issues. - open: Open the thing behind a `door` from `search`. - now: What is happening for the signed-in member right now: who is around, the next 24 hours of calendar, the latest activity across every subject, their own tasks and issues, their quick notes (`quick_notes`, open ones first: to triage one, pass its id as `quick_note` to `task`, `create_issue`, `send_message` or `docs_write`, which files it there), open decisions they asked or owe (`decisions_waiting`, overdue first) and those answered in the last week (`decisions_answered`). - transcript: The finalized record of one meeting the member hosted: notes and transcript text. - send_message: Send a message as the member into a conversation they are in. - task: Create or change a task as the member, or create a new lead or project. - record_decision: Record a decision on a subject, as the member: something the team settled, in one to a few sentences. - ask_decision: Put a decision in the member's decision queue, and read the answers. - set_goal: Create a goal on a project, or change one, as the member. - create_issue: File a GitHub issue on a project's linked repository, as the member. - schedule: Put an event on the member's Google Calendar, as the member. - start_meeting: Schedule a meeting in the member's own Starlings room and ask one of their devices to open it. - cms: Read or change records in Core: website content (CMS entities) and the CRM records `organizations`, `contacts`, `interactions`, `projects` and `leads`. - docs_write: Create or update a document in this workspace's Docs, as the member. ## Changelog - [changelog](https://hq.starlings.work/changelog.md): every release, newest first, as markdown; the page is https://hq.starlings.work/changelog Full text: https://hq.starlings.work/llms-full.txt