> ## Documentation Index
> Fetch the complete documentation index at: https://docs.begin.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Begin MCP

> Connect Claude or ChatGPT to your Begin account and ask about your schedule, hours, and shifts.

<img src="https://mintcdn.com/beginltd/03J4OXXkRY-J3a6R/images/cover/mcp-light.png?fit=max&auto=format&n=03J4OXXkRY-J3a6R&q=85&s=5c7c05e041797419f7242fa3e919795c" alt="Begin MCP" className="block dark:hidden" width="1032" height="552" data-path="images/cover/mcp-light.png" />

<img src="https://mintcdn.com/beginltd/03J4OXXkRY-J3a6R/images/cover/mcp-dark.png?fit=max&auto=format&n=03J4OXXkRY-J3a6R&q=85&s=a1cc54cf2eba76e911ddb65dee359af6" alt="Begin MCP" className="hidden dark:block" width="1032" height="552" data-path="images/cover/mcp-dark.png" />

Begin exposes a Model Context Protocol (MCP) server, so you can ask Claude or ChatGPT about your schedule, your hours, and anything else in your workspace — without leaving the chat. The connection signs in with your Begin account and uses the same permissions you already have.

## What you can do

Once connected, your AI client can answer questions about everything you can see in the web app: your schedule, your hours, the team's schedule for your locations, time-off requests, and messages. Read tools answer immediately.

<Info>
  Your MCP connection has the same access as your account in Begin. It can't do anything you can't
  already do in the web app — if you don't have permission for something, you'll see a clear
  "Permission denied" response.
</Info>

## Example prompts

<Prompt description="Check your next shift." icon="calendar-day">
  When's my next shift?
</Prompt>

<Prompt description="Total your hours for the week." icon="clock">
  How many hours did I work this week?
</Prompt>

<Prompt description="See who's working with you." icon="users">
  Who else is working at our downtown location on Friday?
</Prompt>

<Prompt description="Review your time-off requests." icon="plane-departure">
  Show me my pending time-off requests.
</Prompt>

<Prompt description="Plan your week." icon="calendar-week">
  What's my schedule for next week?
</Prompt>

## Connect Claude

The path is the same on Claude on the web (claude.ai) and Claude Desktop.

<Steps>
  <Step title="Open the connector setup">
    In Claude, go to **Settings → Connectors → Add custom connector**.
  </Step>

  <Step title="Paste the connector URL">Use `https://api.begin.eu/mcp`.</Step>

  <Step title="Sign in to Begin">
    Claude opens a browser tab. Use your normal sign-in method: phone OTP, email OTP, passkey, or
    Google.
  </Step>

  <Step title="Approve the consent screen">Confirm the connection to finish.</Step>
</Steps>

Custom connectors are available on Claude Free, Pro, Max, Team, and Enterprise. Free is capped at one custom connector.

## Connect Claude Code

If you use Claude Code in your terminal, register Begin as a remote MCP server with one command.

```bash theme={null}
claude mcp add --transport http begin https://api.begin.eu/mcp
```

Then run `/mcp` inside Claude Code to authenticate. Claude Code opens a browser window to sign in to Begin and approve the connection. Subsequent sessions reuse the cached token.

## Connect ChatGPT

ChatGPT requires turning on Developer mode before you can create an app.

<Steps>
  <Step title="Open Advanced settings">
    In ChatGPT, click your profile picture and go to **Settings → Apps → Advanced settings**.
  </Step>

  <Step title="Turn on Developer mode">
    Toggle **Developer mode** on.

    <Frame caption="Toggle Developer mode under Settings → Apps → Advanced settings.">
      <img src="https://mintcdn.com/beginltd/03J4OXXkRY-J3a6R/images/articles/mcp/chatgpt.png?fit=max&auto=format&n=03J4OXXkRY-J3a6R&q=85&s=4ff968edb7612cc538d678554ee3efd2" alt="ChatGPT Settings panel with the Developer mode toggle highlighted" width="3810" height="2144" data-path="images/articles/mcp/chatgpt.png" />
    </Frame>
  </Step>

  <Step title="Click Create app">
    The button appears next to **Advanced settings** once Developer mode is on.
  </Step>

  <Step title="Enter the connector details">
    Use `https://api.begin.eu/mcp` as the MCP server URL, plus a name and short description.

    <Frame caption="Paste the Begin MCP server URL into the New app dialog.">
      <img src="https://mintcdn.com/beginltd/03J4OXXkRY-J3a6R/images/articles/mcp/chatgpt-add-app.png?fit=max&auto=format&n=03J4OXXkRY-J3a6R&q=85&s=ac3994b726660e580b8791d121ff702f" alt="ChatGPT New app dialog with fields for name, description, and MCP server URL" width="3980" height="2238" data-path="images/articles/mcp/chatgpt-add-app.png" />
    </Frame>
  </Step>

  <Step title="Sign in to Begin">In the popup, sign in and approve the consent screen.</Step>
</Steps>

<Info>
  Custom apps are available on ChatGPT Pro, Plus, Business, Enterprise, and Education. They aren't
  available on Free. On Business, Enterprise, and Education, your workspace admin needs to enable
  Developer mode for you.
</Info>

## Workspace pinning

If you belong to more than one Begin workspace, your MCP connection is **pinned to whichever workspace is active the first time your client uses the connection**. Once pinned, switching workspace in the web app does not change the workspace your MCP client uses.

To switch:

<Steps>
  <Step title="Switch your active workspace">
    In the Begin web app, set the target workspace as active.
  </Step>

  <Step title="Revoke the existing connection">
    In **Settings → Security → Connected MCP clients**, revoke the current pin.
  </Step>

  <Step title="Reconnect from your MCP client">Your next request pins to the new workspace.</Step>
</Steps>

## Manage connected clients

**Settings → Security → Connected MCP clients** shows every MCP client you've authorized, the workspace each is pinned to, and when each was last active. Revoke a client anytime.

## Permissions and security

* Your MCP connection has the same permissions as your account. Never more.
* Connections are scoped to one workspace at a time.
* Tokens are short-lived (1 hour) with refresh-token rotation; clients refresh them silently.
* Every action is written to the workspace audit log under your name.