[{"data":1,"prerenderedAt":366},["ShallowReactive",2],{"navigation":3,"page:\u002Fclaude":45},{"title":4,"links":5},"API reference",[6,9,12,15,18,21,24,27,30,33,36,39,42],{"title":7,"href":8},"Accounts","\u002Freference\u002Faccounts",{"title":10,"href":11},"Connect","\u002Freference\u002Fconnect",{"title":13,"href":14},"Calendars","\u002Freference\u002Fcalendars",{"title":16,"href":17},"Events","\u002Freference\u002Fevents",{"title":19,"href":20},"Availability","\u002Freference\u002Favailability",{"title":22,"href":23},"Meetings","\u002Freference\u002Fmeetings",{"title":25,"href":26},"Invitations","\u002Freference\u002Finvitations",{"title":28,"href":29},"Webhooks","\u002Freference\u002Fwebhooks",{"title":31,"href":32},"Metadata","\u002Freference\u002Fmetadata",{"title":34,"href":35},"Keys","\u002Freference\u002Fkeys",{"title":37,"href":38},"Sandbox","\u002Freference\u002Fsandbox",{"title":40,"href":41},"Usage","\u002Freference\u002Fusage",{"title":43,"href":44},"Logs","\u002Freference\u002Flogs",{"kind":46,"title":47,"description":48,"sections":49,"doc":68},"guide","Claude","Add Pyas to Claude as a custom connector, sign in to Pyas, and ask about your app's calendars in a chat. Find a time everyone is free, see someone's week, or book a meeting.",[50,53,56,59,62,65],{"id":51,"title":52},"add-pyas-to-claude","Add Pyas to Claude",{"id":54,"title":55},"sign-in","Sign in",{"id":57,"title":58},"choose-what-needs-your-approval","Choose what needs your approval",{"id":60,"title":61},"use-it-in-a-chat","Use it in a chat",{"id":63,"title":64},"live-calendars","Live calendars",{"id":66,"title":67},"disconnect","Disconnect",{"id":69,"title":47,"body":70,"description":48,"extension":357,"hero":358,"meta":359,"navigation":360,"path":361,"rawbody":362,"sections":49,"seo":363,"stem":76,"v1":364,"__hash__":365},"docs\u002Fclaude.md",{"type":71,"value":72,"toc":346},"minimark",[73,77,84,98,106,109,169,172,181,183,186,200,207,209,212,215,245,255,257,263,269,274,279,282,285,291,293,296,311,318,324,326,336],[74,75,47],"h1",{"id":76},"claude",[78,79,80],"lead",{},[81,82,83],"p",{},"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.",[81,85,86,87,91,92,97],{},"Start with the sandbox address, ",[88,89,90],"code",{},"https:\u002F\u002Fmcp.pyas.io\u002Fsandbox",". It works in your app's ",[93,94,96],"a",{"href":95},"\u002Fsandbox","sandbox",", on sample people, calendars and events, so nothing you try reaches a real calendar.",[81,99,100,101,105],{},"To use Pyas while you code in a terminal, see ",[93,102,104],{"href":103},"\u002Fclaude-code","Claude Code"," instead.",[107,108,52],"h2",{"id":51},[110,111,112,125,134,143,161],"ol",{},[113,114,115,116,120,121,124],"li",{},"In Claude, open ",[117,118,119],"strong",{},"Customize",", then ",[117,122,123],{},"Connectors",".",[113,126,127,128,120,131,124],{},"Select ",[117,129,130],{},"+ Add",[117,132,133],{},"Add custom connector",[113,135,136,137,140,141,124],{},"Enter the name ",[88,138,139],{},"Pyas sandbox"," and the address ",[88,142,90],{},[113,144,145,146,149,150,153,154,157,158,124],{},"Claude finds how Pyas signs in by itself. Leave ",[117,147,148],{},"Sign in now"," and ",[117,151,152],{},"Use Claude's published identity"," selected, leave ",[117,155,156],{},"Request headers"," empty, and select ",[117,159,160],{},"Add",[113,162,127,163,120,165,124],{},[117,164,10],{},[93,166,168],{"href":167},"#sign-in","sign in",[81,170,171],{},"Once it's connected, Pyas works in Claude on the web and in Claude's apps.",[81,173,174,175,120,178,180],{},"On a Team or Enterprise plan, an owner adds the connector under ",[117,176,177],{},"Organization settings",[117,179,123],{},", and each member then connects it. On the Free plan, you can add one custom connector.",[107,182,55],{"id":54},[81,184,185],{},"When you connect, your browser opens the Pyas dashboard:",[110,187,188,191,194],{},[113,189,190],{},"Sign in, or create an account.",[113,192,193],{},"Choose the app that Claude works with.",[113,195,196,197,124],{},"Check what Claude asks for, and select ",[117,198,199],{},"Allow",[81,201,202,203,206],{},"You're then back in Claude. See ",[93,204,55],{"href":205},"\u002Fai-tools#sign-in"," for what each permission allows.",[107,208,58],{"id":57},[81,210,211],{},"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.",[81,213,214],{},"We suggest:",[216,217,218,224],"ul",{},[113,219,220,223],{},[117,221,222],{},"Read-only tools",": let Claude use them without asking. They only read, such as listing events or finding a free time.",[113,225,226,229,230,233,234,237,238,241,242,124],{},[117,227,228],{},"The other tools",": keep ",[117,231,232],{},"Needs approval",", at least for creating, updating and deleting events. Claude then shows what it's about to do, and you select ",[117,235,236],{},"Allow once",", ",[117,239,240],{},"Always allow"," or ",[117,243,244],{},"Decline",[81,246,247,248,250,251,254],{},"In Claude's Auto mode, Claude can use a tool without asking, even one set to ",[117,249,232],{},". On live calendars, Pyas still asks you to confirm each change (see ",[93,252,64],{"href":253},"#live-calendars",").",[107,256,61],{"id":60},[81,258,259,260,262],{},"Start a new chat, check that ",[117,261,139],{}," is on in the chat's tools menu, and ask in plain words:",[264,265,266],"blockquote",{},[81,267,268],{},"What accounts do I have in Pyas?",[264,270,271],{},[81,272,273],{},"Find a 30 minute slot for Avery and Riley tomorrow afternoon and book it.",[264,275,276],{},[81,277,278],{},"Add a Zoom link to that meeting.",[81,280,281],{},"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.",[81,283,284],{},"Claude reads Pyas's tools when a chat starts. When Pyas adds a tool or an option, start a new chat to use it.",[81,286,287,288,290],{},"Every request Claude makes is on the ",[117,289,43],{}," page in the dashboard, marked with the tool that made it.",[107,292,64],{"id":63},[81,294,295],{},"To work on the real calendars that people connected to your app, add a second connector:",[110,297,298,308],{},[113,299,300,301,304,305,124],{},"Add ",[88,302,303],{},"https:\u002F\u002Fmcp.pyas.io"," the same way, with the name ",[88,306,307],{},"Pyas live",[113,309,310],{},"When you sign in, choose whether Claude may only read live calendars, or change them too.",[81,312,313,314,317],{},"Before Claude changes a live calendar, you confirm the change in Pyas, from a link that Claude gives you. See ",[93,315,64],{"href":316},"\u002Fai-tools#live-calendars"," for how that works and who can confirm.",[81,319,320,321,323],{},"While you work in the sandbox, turn ",[117,322,307],{}," off in the chat's tools menu, so Claude can't mix up the two.",[107,325,67],{"id":66},[81,327,328,329,120,331,333,334,124],{},"To disconnect in Claude, open the connector under ",[117,330,119],{},[117,332,123],{},", and select ",[117,335,67],{},[81,337,338,339,342,343,345],{},"On your profile in the Pyas dashboard, ",[117,340,341],{},"Connected tools"," lists Claude with when it was last used. ",[117,344,67],{}," there stops it immediately, from Pyas's side. To use it again, connect it again from Claude.",{"title":347,"searchDepth":348,"depth":348,"links":349},"",3,[350,352,353,354,355,356],{"id":51,"depth":351,"text":52},2,{"id":54,"depth":351,"text":55},{"id":57,"depth":351,"text":58},{"id":60,"depth":351,"text":61},{"id":63,"depth":351,"text":64},{"id":66,"depth":351,"text":67},"md",false,{},true,"\u002Fclaude","---\ntitle: Claude\ndescription: Add Pyas to Claude as a custom connector, sign in to Pyas, and ask about your app's calendars in a chat. Find a time everyone is free, see someone's week, or book a meeting.\nsections:\n  - { id: add-pyas-to-claude, title: Add Pyas to Claude }\n  - { id: sign-in, title: Sign in }\n  - { id: choose-what-needs-your-approval, title: Choose what needs your approval }\n  - { id: use-it-in-a-chat, title: Use it in a chat }\n  - { id: live-calendars, title: Live calendars }\n  - { id: disconnect, title: Disconnect }\n---\n\n# Claude\n\n::lead\nAdd 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.\n::\n\nStart with the sandbox address, `https:\u002F\u002Fmcp.pyas.io\u002Fsandbox`. It works in your app's [sandbox](\u002Fsandbox), on sample people, calendars and events, so nothing you try reaches a real calendar.\n\nTo use Pyas while you code in a terminal, see [Claude Code](\u002Fclaude-code) instead.\n\n## Add Pyas to Claude\n\n1. In Claude, open **Customize**, then **Connectors**.\n2. Select **+ Add**, then **Add custom connector**.\n3. Enter the name `Pyas sandbox` and the address `https:\u002F\u002Fmcp.pyas.io\u002Fsandbox`.\n4. 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**.\n5. Select **Connect**, then [sign in](#sign-in).\n\nOnce it's connected, Pyas works in Claude on the web and in Claude's apps.\n\nOn 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.\n\n## Sign in\n\nWhen you connect, your browser opens the Pyas dashboard:\n\n1. Sign in, or create an account.\n2. Choose the app that Claude works with.\n3. Check what Claude asks for, and select **Allow**.\n\nYou're then back in Claude. See [Sign in](\u002Fai-tools#sign-in) for what each permission allows.\n\n## Choose what needs your approval\n\nThe 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.\n\nWe suggest:\n\n- **Read-only tools**: let Claude use them without asking. They only read, such as listing events or finding a free time.\n- **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**.\n\nIn 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](#live-calendars)).\n\n## Use it in a chat\n\nStart a new chat, check that **Pyas sandbox** is on in the chat's tools menu, and ask in plain words:\n\n> What accounts do I have in Pyas?\n\n> Find a 30 minute slot for Avery and Riley tomorrow afternoon and book it.\n\n> Add a Zoom link to that meeting.\n\nThe 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.\n\nClaude reads Pyas's tools when a chat starts. When Pyas adds a tool or an option, start a new chat to use it.\n\nEvery request Claude makes is on the **Logs** page in the dashboard, marked with the tool that made it.\n\n## Live calendars\n\nTo work on the real calendars that people connected to your app, add a second connector:\n\n1. Add `https:\u002F\u002Fmcp.pyas.io` the same way, with the name `Pyas live`.\n2. When you sign in, choose whether Claude may only read live calendars, or change them too.\n\nBefore Claude changes a live calendar, you confirm the change in Pyas, from a link that Claude gives you. See [Live calendars](\u002Fai-tools#live-calendars) for how that works and who can confirm.\n\nWhile you work in the sandbox, turn **Pyas live** off in the chat's tools menu, so Claude can't mix up the two.\n\n## Disconnect\n\nTo disconnect in Claude, open the connector under **Customize**, then **Connectors**, and select **Disconnect**.\n\nOn 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.\n",{"title":47,"description":48},null,"B7dRhx7bboqH5A66NuGl_3dQEgyFOhnuYoEsWFBdAms",1794697270826]