Setup Wizard

The BookYourPTO wizard is a small command-line tool that connects the AI assistants on your computer to BookYourPTO in one step. Run it, choose your clients, restart them, and ask your assistant about your time off.

npx -y @bookyourpto/wizard@latest mcp add

It needs Node.js 18 or later, which also provides npx. Nothing is installed permanently: npx downloads the wizard, runs it and leaves it in its cache.

When it finishes, each client you picked is connected to https://mcp.bookyourpto.com/mcp, and the first question you ask opens BookYourPTO's sign-in page in your browser.

How it works

1. Looks for the AI clients installed on your computer (see Supported AI clients).
2. Lists the ones it found and asks which to connect. Press Enter for all of them, or type numbers such as 1,3.
3. Adds a server named bookyourpto to each chosen client's MCP settings. Only the server address is written.
4. Backs up every settings file before changing it, and leaves all your other servers exactly as they were.
5. For clients that are connected from inside the app rather than from a settings file, prints the steps to follow.
6. Tells you to restart the clients. The first time one of them uses BookYourPTO, your browser opens so you can sign in, with two-factor authentication if your account has it.

Supported AI clients

ChatGPT and other clients that are set up in their own app are not changed by the wizard. Follow the steps for your client in Connecting.

Commands

Running npx @bookyourpto/wizard mcp add starts the setup. The wizard also has these commands:

Options

Options work with every command.

For example, to connect only Cursor and VS Code without being asked:

npx -y @bookyourpto/wizard@latest mcp add --client cursor,vscode

When the wizard is not run in an interactive terminal (in a script, for example), it connects every client it finds, as if --all were given.

What it changes on your computer

• Settings files. Only the bookyourpto entry is added, updated or removed. Before writing, the wizard copies the file to <file>.bak-<date and time> next to it, then saves the new version in one step, so an interrupted run never leaves a half-written file. Files it creates can be read only by you.
• Claude Code. Changes go through Claude Code's own claude mcp command rather than editing its files directly. If BookYourPTO is already set up, the wizard replaces the entry so a new address takes effect.
• Files it cannot read safely. If a settings file contains comments or is not plain JSON, the wizard leaves it untouched and prints the exact entry for you to add yourself.
• Nothing else. The wizard sends no analytics and makes no network requests of its own. The only download is the wizard itself, fetched by npx.

Troubleshooting

"No supported AI client was found on this computer"

The wizard looks for each client's settings folder. Open the client once so it creates them, then run the wizard again. You can also add the server by hand: see Connecting.

A client shows "not changed" and prints an entry

Its settings file has comments or is not plain JSON, so the wizard did not risk rewriting it. Paste the printed entry into the file yourself.

npx is not found

Install Node.js 18 or later from nodejs.org, open a new terminal, and run the command again.

The tools do not appear after setup

Restart the client completely. In Claude Code, run /mcp to see the server and start the sign-in. Then check Troubleshooting in Connecting.

Undoing it

Run npx @bookyourpto/wizard mcp remove, or restore the .bak- copy the wizard made next to the settings file.

Feedback

The wizard is open to everyone at npmjs.com/package/@bookyourpto/wizard. If a client you use is missing, or the wizard did something unexpected, email support@bookyourpto.com.