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

VS Code

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.

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.

You need VS Code 1.99 or later. On Copilot Business or Enterprise, an administrator must turn on the MCP servers in Copilot policy first.

To use Pyas with Claude Code's extension for VS Code instead, see Claude Code.

Add Pyas to VS Code

Select Add to VS Code. VS Code opens the server's page, where you install it.

Or add it yourself:

  1. Open the Command Palette and run MCP: Add Server.
  2. Choose HTTP (HTTP or Server-Sent Events), and enter https://mcp.pyas.io/sandbox.
  3. For the server ID, enter pyas-sandbox.
  4. Choose Global to use it in every project.

Sign in

The first time VS Code connects to Pyas, it asks you to sign in, and your browser opens the Pyas dashboard:

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

Go back to VS Code. See Sign in for what each permission allows.

Use it while you code

Open the chat, choose Agent, and ask in plain words, in the project you're working on:

Set up Pyas in this app so people can connect their Google or Outlook calendar.

The 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.

What's on Avery's calendar tomorrow?

My last request to Pyas failed. Why?

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 get_request and explain_error, from its trace ID.

To 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.

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

Choose what needs your approval

VS 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.

Keep being asked for the tools that change something, at least on the live server.

Live calendars

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

  1. Run MCP: Add Server again, with https://mcp.pyas.io and the server ID pyas-live.
  2. When you sign in, choose whether the agent may only read live calendars, or change them too.

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

While you work in the sandbox, stop the live server: run MCP: List Servers, select pyas-live, then Stop Server.

Disconnect

To remove Pyas from VS Code, run MCP: List Servers, select the server, then Uninstall.

To 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.