Claude

Add Pyas to Claude, and you can ask about your app's calendars in a chat: who is free tomorrow, what is on someone's week, or book a meeting with a video link. You add Pyas by its address and sign in. There is nothing to install and no key to copy.

Start with the sandbox address, https://mcp.pyas.io/sandbox. It works in your app's sandbox, on sample people, calendars and events, so nothing you try reaches a real calendar.

To use Pyas while you code in a terminal, see Claude Code instead.

Add Pyas to Claude

In Claude, open Customize, then Connectors.
Select + Add, then Add custom connector.
Enter the name Pyas sandbox and the address https://mcp.pyas.io/sandbox.
Claude finds how Pyas signs in by itself. Leave Sign in now and Use Claude's published identity selected, leave Request headers empty, and select Add.
Select Connect, then sign in.

Once it's connected, Pyas works in Claude on the web and in Claude's apps.

On a Team or Enterprise plan, an owner adds the connector under Organization settings, then Connectors, and each member then connects it. On the Free plan, you can add one custom connector.

When you connect, your browser opens the Pyas dashboard:

Sign in, or create an account.
Choose the app that Claude works with.
Check what Claude asks for, and select Allow.

You're then back in Claude. See Sign in for what each permission allows.

Choose what needs your approval

The connector's page in Claude lists Pyas's tools by name, with the read-only tools in their own group. For each tool, or each group, you choose whether Claude may use it without asking, needs your approval first, or can't use it.

We suggest:

Read-only tools: let Claude use them without asking. They only read, such as listing events or finding a free time.
The other tools: keep Needs approval, at least for creating, updating and deleting events. Claude then shows what it's about to do, and you select Allow once, Always allow or Decline.

In Claude's Auto mode, Claude can use a tool without asking, even one set to Needs approval. On live calendars, Pyas still asks you to confirm each change (see Live calendars).

Use it in a chat

Start a new chat, check that Pyas sandbox is on in the chat's tools menu, and ask in plain words:

What accounts do I have in Pyas?

Find a 30 minute slot for Avery and Riley tomorrow afternoon and book it.

Add a Zoom link to that meeting.

The sandbox's sample people, such as Avery Brooks and Riley Chen, have calendars with a week of events, so these work as soon as you connect.

Claude reads Pyas's tools when a chat starts. When Pyas adds a tool or an option, start a new chat to use it.

Every request Claude makes is on the Logs page in the dashboard, marked with the tool that made it.

Live calendars

To work on the real calendars that people connected to your app, add a second connector:

Add https://mcp.pyas.io the same way, with the name Pyas live.
When you sign in, choose whether Claude may only read live calendars, or change them too.

Before Claude changes a live calendar, you confirm the change in Pyas, from a link that Claude gives you. See Live calendars for how that works and who can confirm.

While you work in the sandbox, turn Pyas live off in the chat's tools menu, so Claude can't mix up the two.

Disconnect

To disconnect in Claude, open the connector under Customize, then Connectors, and select Disconnect.

On your profile in the Pyas dashboard, Connected tools lists Claude with when it was last used. Disconnect there stops it immediately, from Pyas's side. To use it again, connect it again from Claude.