[{"data":1,"prerenderedAt":361},["ShallowReactive",2],{"navigation":3,"page:\u002Fvs-code":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","VS Code","Add the Pyas MCP server to GitHub Copilot in VS Code, sign in to Pyas, and let the agent set up your app, write the integration and check your sandbox while you code.",[50,53,56,59,62,65],{"id":51,"title":52},"add-pyas-to-vs-code","Add Pyas to VS Code",{"id":54,"title":55},"sign-in","Sign in",{"id":57,"title":58},"use-it-while-you-code","Use it while you code",{"id":60,"title":61},"choose-what-needs-your-approval","Choose what needs your approval",{"id":63,"title":64},"live-calendars","Live calendars",{"id":66,"title":67},"disconnect","Disconnect",{"id":69,"title":47,"body":70,"description":48,"extension":352,"hero":353,"meta":354,"navigation":355,"path":356,"rawbody":357,"sections":49,"seo":358,"stem":76,"v1":359,"__hash__":360},"docs\u002Fvs-code.md",{"type":71,"value":72,"toc":341},"minimark",[73,77,84,98,106,114,117,125,128,159,161,164,178,185,187,194,200,223,228,233,244,255,261,263,274,277,279,282,300,307,320,322,331],[74,75,47],"h1",{"id":76},"vs-code",[78,79,80],"lead",{},[81,82,83],"p",{},"Add Pyas to GitHub Copilot in VS Code, and its agent can set up your Pyas app, write the code that connects calendars, and check your sandbox while you code. 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],{},"You need VS Code 1.99 or later. On Copilot Business or Enterprise, an administrator must turn on the ",[102,103,104],"strong",{},"MCP servers in Copilot"," policy first.",[81,107,108,109,113],{},"To use Pyas with Claude Code's extension for VS Code instead, see ",[93,110,112],{"href":111},"\u002Fclaude-code","Claude Code",".",[115,116,52],"h2",{"id":51},[81,118,119,120,124],{},"Select ",[93,121,123],{"href":122},"vscode:mcp\u002Finstall?%7B%22name%22%3A%22pyas-sandbox%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.pyas.io%2Fsandbox%22%7D","Add to VS Code",". VS Code opens the server's page, where you install it.",[81,126,127],{},"Or add it yourself:",[129,130,131,138,147,153],"ol",{},[132,133,134,135,113],"li",{},"Open the Command Palette and run ",[102,136,137],{},"MCP: Add Server",[132,139,140,141,144,145,113],{},"Choose ",[102,142,143],{},"HTTP (HTTP or Server-Sent Events)",", and enter ",[88,146,90],{},[132,148,149,150,113],{},"For the server ID, enter ",[88,151,152],{},"pyas-sandbox",[132,154,140,155,158],{},[102,156,157],{},"Global"," to use it in every project.",[115,160,55],{"id":54},[81,162,163],{},"The first time VS Code connects to Pyas, it asks you to sign in, and your browser opens the Pyas dashboard:",[129,165,166,169,172],{},[132,167,168],{},"Sign in, or create an account.",[132,170,171],{},"Choose the app that VS Code works with.",[132,173,174,175,113],{},"Check what VS Code asks for, and select ",[102,176,177],{},"Allow",[81,179,180,181,184],{},"Go back to VS Code. See ",[93,182,55],{"href":183},"\u002Fai-tools#sign-in"," for what each permission allows.",[115,186,58],{"id":57},[81,188,189,190,193],{},"Open the chat, choose ",[102,191,192],{},"Agent",", and ask in plain words, in the project you're working on:",[195,196,197],"blockquote",{},[81,198,199],{},"Set up Pyas in this app so people can connect their Google or Outlook calendar.",[81,201,202,203,206,207,210,211,214,215,218,219,222],{},"The agent checks your app's setup with ",[88,204,205],{},"setup_status",", gets the code for your stack with ",[88,208,209],{},"get_recipe",", and creates a test key with ",[88,212,213],{},"get_test_key",". It tells you where to store the key, such as ",[88,216,217],{},"PYAS_API_KEY"," in your ",[88,220,221],{},".env"," file. Recipes cover Next.js and Express, and the AI app builders.",[195,224,225],{},[81,226,227],{},"What's on Avery's calendar tomorrow?",[195,229,230],{},[81,231,232],{},"My last request to Pyas failed. Why?",[81,234,235,236,239,240,243],{},"The sandbox's sample people, such as Avery Brooks and Riley Chen, have calendars with a week of events. For a failed request, the agent looks it up with ",[88,237,238],{},"get_request"," and ",[88,241,242],{},"explain_error",", from its trace ID.",[81,245,246,247,250,251,254],{},"To choose which Pyas tools the agent can use, select ",[102,248,249],{},"Configure Tools"," in the chat. When Pyas adds a tool, run ",[102,252,253],{},"MCP: Reset Cached Tools"," to see it.",[81,256,257,258,260],{},"Every request VS Code makes is on the ",[102,259,43],{}," page in the dashboard, marked with the tool that made it.",[115,262,61],{"id":60},[81,264,265,266,269,270,273],{},"VS Code asks you before the agent uses a Pyas tool. Select ",[102,267,268],{},"Allow Once",", or ",[102,271,272],{},"Always Allow"," for a tool that only reads, such as listing events.",[81,275,276],{},"Keep being asked for the tools that change something, at least on the live server.",[115,278,64],{"id":63},[81,280,281],{},"To work on the real calendars that people connected to your app, add a second server:",[129,283,284,297],{},[132,285,286,287,289,290,293,294,113],{},"Run ",[102,288,137],{}," again, with ",[88,291,292],{},"https:\u002F\u002Fmcp.pyas.io"," and the server ID ",[88,295,296],{},"pyas-live",[132,298,299],{},"When you sign in, choose whether the agent may only read live calendars, or change them too.",[81,301,302,303,306],{},"Before the agent changes a live calendar, you confirm the change in Pyas, from a link that it gives you. See ",[93,304,64],{"href":305},"\u002Fai-tools#live-calendars"," for how that works and who can confirm.",[81,308,309,310,313,314,316,317,113],{},"While you work in the sandbox, stop the live server: run ",[102,311,312],{},"MCP: List Servers",", select ",[102,315,296],{},", then ",[102,318,319],{},"Stop Server",[115,321,67],{"id":66},[81,323,324,325,327,328,113],{},"To remove Pyas from VS Code, run ",[102,326,312],{},", select the server, then ",[102,329,330],{},"Uninstall",[81,332,333,334,337,338,340],{},"To stop VS Code from Pyas's side, open your profile in the Pyas dashboard. ",[102,335,336],{},"Connected tools"," lists VS Code with when it was last used, and ",[102,339,67],{}," stops it immediately. To use it again, add it again and sign in.",{"title":342,"searchDepth":343,"depth":343,"links":344},"",3,[345,347,348,349,350,351],{"id":51,"depth":346,"text":52},2,{"id":54,"depth":346,"text":55},{"id":57,"depth":346,"text":58},{"id":60,"depth":346,"text":61},{"id":63,"depth":346,"text":64},{"id":66,"depth":346,"text":67},"md",false,{},true,"\u002Fvs-code","---\ntitle: VS Code\ndescription: Add the Pyas MCP server to GitHub Copilot in VS Code, sign in to Pyas, and let the agent set up your app, write the integration and check your sandbox while you code.\nsections:\n  - { id: add-pyas-to-vs-code, title: Add Pyas to VS Code }\n  - { id: sign-in, title: Sign in }\n  - { id: use-it-while-you-code, title: Use it while you code }\n  - { id: choose-what-needs-your-approval, title: Choose what needs your approval }\n  - { id: live-calendars, title: Live calendars }\n  - { id: disconnect, title: Disconnect }\n---\n\n# VS Code\n\n::lead\nAdd Pyas to GitHub Copilot in VS Code, and its agent can set up your Pyas app, write the code that connects calendars, and check your sandbox while you code. 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\nYou need VS Code 1.99 or later. On Copilot Business or Enterprise, an administrator must turn on the **MCP servers in Copilot** policy first.\n\nTo use Pyas with Claude Code's extension for VS Code instead, see [Claude Code](\u002Fclaude-code).\n\n## Add Pyas to VS Code\n\nSelect [Add to VS Code](vscode:mcp\u002Finstall?%7B%22name%22%3A%22pyas-sandbox%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.pyas.io%2Fsandbox%22%7D). VS Code opens the server's page, where you install it.\n\nOr add it yourself:\n\n1. Open the Command Palette and run **MCP: Add Server**.\n2. Choose **HTTP (HTTP or Server-Sent Events)**, and enter `https:\u002F\u002Fmcp.pyas.io\u002Fsandbox`.\n3. For the server ID, enter `pyas-sandbox`.\n4. Choose **Global** to use it in every project.\n\n## Sign in\n\nThe first time VS Code connects to Pyas, it asks you to sign in, and your browser opens the Pyas dashboard:\n\n1. Sign in, or create an account.\n2. Choose the app that VS Code works with.\n3. Check what VS Code asks for, and select **Allow**.\n\nGo back to VS Code. See [Sign in](\u002Fai-tools#sign-in) for what each permission allows.\n\n## Use it while you code\n\nOpen the chat, choose **Agent**, and ask in plain words, in the project you're working on:\n\n> Set up Pyas in this app so people can connect their Google or Outlook calendar.\n\nThe agent checks your app's setup with `setup_status`, gets the code for your stack with `get_recipe`, and creates a test key with `get_test_key`. It tells you where to store the key, such as `PYAS_API_KEY` in your `.env` file. Recipes cover Next.js and Express, and the AI app builders.\n\n> What's on Avery's calendar tomorrow?\n\n> My last request to Pyas failed. Why?\n\nThe sandbox's sample people, such as Avery Brooks and Riley Chen, have calendars with a week of events. For a failed request, the agent looks it up with `get_request` and `explain_error`, from its trace ID.\n\nTo choose which Pyas tools the agent can use, select **Configure Tools** in the chat. When Pyas adds a tool, run **MCP: Reset Cached Tools** to see it.\n\nEvery request VS Code makes is on the **Logs** page in the dashboard, marked with the tool that made it.\n\n## Choose what needs your approval\n\nVS Code asks you before the agent uses a Pyas tool. Select **Allow Once**, or **Always Allow** for a tool that only reads, such as listing events.\n\nKeep being asked for the tools that change something, at least on the live server.\n\n## Live calendars\n\nTo work on the real calendars that people connected to your app, add a second server:\n\n1. Run **MCP: Add Server** again, with `https:\u002F\u002Fmcp.pyas.io` and the server ID `pyas-live`.\n2. When you sign in, choose whether the agent may only read live calendars, or change them too.\n\nBefore the agent changes a live calendar, you confirm the change in Pyas, from a link that it gives you. See [Live calendars](\u002Fai-tools#live-calendars) for how that works and who can confirm.\n\nWhile you work in the sandbox, stop the live server: run **MCP: List Servers**, select **pyas-live**, then **Stop Server**.\n\n## Disconnect\n\nTo remove Pyas from VS Code, run **MCP: List Servers**, select the server, then **Uninstall**.\n\nTo stop VS Code from Pyas's side, open your profile in the Pyas dashboard. **Connected tools** lists VS Code with when it was last used, and **Disconnect** stops it immediately. To use it again, add it again and sign in.\n",{"title":47,"description":48},null,"IQUCmPedbTH27rkZEyVmcDV3V9-ygB8dP-dSVPJdZvY",1794697271033]