Using API v1? See what changes in v2, or the v1 docs

ChatGPT

Add Pyas to ChatGPT, 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.

Add Pyas to ChatGPT

You add Pyas on chatgpt.com, as a custom plugin.

  1. Go to chatgpt.com/plugins (opens in a new tab).
  2. Select +, then Add custom MCP server.
  3. Enter the name Pyas sandbox and the address https://mcp.pyas.io/sandbox. For authentication, choose OAuth.
  4. Select Create as a plugin.
  5. Select Connect Pyas sandbox, then sign in.

ChatGPT shows a plugin you add with its own icon, and lists you as the plugin's developer, because you added it.

Sign in

When you connect, your browser opens the Pyas dashboard:

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

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

Use it in a chat

In a new chat, type @, choose Pyas sandbox, and ask in plain words:

@Pyas sandbox What meetings does Sam Patel have this week?

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 Sam Patel, have calendars with a week of events, so these work as soon as you connect. ChatGPT asks you before it uses a tool that changes something, such as booking a meeting.

Every request ChatGPT 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 plugin:

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

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

Disconnect

On your profile in the Pyas dashboard, Connected tools lists ChatGPT with when it was last used. Select Disconnect to stop it immediately. To use it again, connect it again from ChatGPT.