Connect ChatGPT or Claude to your family calendar

Quok speaks MCP (Model Context Protocol), the open standard AI apps use to work with your tools. Connect an app once, and it can help with your family calendar, tasks, shopping, and lists, and invite your partner with a share link.

AI app connections are free for every family. The AI app may also require a paid plan or workspace permission to add a custom MCP connection.

Get the Quok server address

1. Open Connect your AI in Quok. You can also open Preferences → Connect an AI app in the web app. In the iPhone or iPad app, open Settings → Connect to your AI. In the Android app, open Settings → Connect AI apps.

2. Under Connect in one minute, choose Copy address.

3. Paste the address into your AI app when it asks for a server address, MCP server, or connector URL.

The address ends in /mcp. Copy it from Quok to avoid a missing path, an extra slash, or a typing mistake.

Connect Claude

1. In Claude, open Settings → Connectors.

2. Choose Add custom connector, name it Quok, and paste the Quok server address.

3. Add the connector, then choose Connect.

4. Sign in to Quok in the browser window. Review the app name, your family, and the access it requests, then choose Allow access.

Connect ChatGPT

Quok is an app in ChatGPT, so you don’t need the server address.

1. Open Quok in ChatGPT and connect it. In Quok, the ChatGPT guide under Pick your app has an Open Quok in ChatGPT button that goes to the same page.

2. Sign in to Quok in the browser window. Review the request and choose Allow access.

3. Start a chat and ask about your family’s week, lists, or chores.

If your ChatGPT workspace can’t add apps

Some workspaces let only an administrator add apps. If your plan offers it, you can add Quok as a custom app in developer mode instead. Check OpenAI’s developer mode guide for the current requirements.

1. In ChatGPT on the web, open Settings → Apps → Advanced Settings and turn on Developer mode.

2. From your user or workspace Apps settings, choose Create.

3. Name the app Quok, paste the Quok server address, and select OAuth authentication.

4. When ChatGPT scans the available tools, sign in to Quok. Review the request and choose Allow access.

5. Finish creating the app, then enable Quok from the apps menu in a new chat.

Connect Claude Code

Run this command once in your terminal:

claude mcp add --transport http quok https://api.getquok.com/mcp

Claude Code opens a browser when it needs to authenticate. Sign in to Quok, review the request, and choose Allow access. You can inspect or reconnect the server later with /mcp. See the Claude Code MCP guide from Anthropic for more client commands.

Connect Cursor

Add Quok as a remote MCP server in Settings → MCP → Add new MCP server, using the server address https://api.getquok.com/mcp over HTTP.

Cursor opens a browser the first time it needs access. Sign in to Quok, review the request, and choose Allow access. Cursor then loads the Quok tools. No client ID or secret is needed.

Connect another MCP app

If the app supports automatic OAuth registration, paste the Quok server address and follow its sign-in prompt. Quok publishes the discovery information the app needs.

Some apps ask for a client ID and client secret instead. An organizer or adult can create those OAuth credentials in Quok:

1. Open Preferences → Connect an AI app → Connect your own app.

2. Enter an app name and select Custom callback URL.

3. Copy the exact callback URL from the app into Quok, then choose Create credentials.

4. Copy the server address, client ID, and client secret into the app. Quok shows the secret only once.

5. Continue from the app. When it sends you back to Quok, sign in and choose Allow access.

Use a connection key

If an app can’t open a sign-in window, give it a connection key instead. A key acts as you, so treat it like a password. An organizer or adult can create one on the web or in the mobile apps:

1. Open Connect your AI and find If your app can’t sign in → Use a connection key.

2. Name the connection, for example Kitchen screen, and choose Create key.

3. Copy the key into the app. Quok shows the key only once.

The list under the key shows each active key, who added it, and when it was last used.

For the complete Home Assistant path, including voice configuration, see Connect Home Assistant to Quok.

Check the connection

Ask the assistant, “What’s on our family calendar this week?” Then try a small change, such as “Add milk to the shopping list.” If it can read and update Quok, the connection is ready.

Some AI apps require you to enable Quok for each chat. Look for it in the app’s tools, connectors, or apps menu if the assistant says it cannot access Quok.

Disconnect an app

• For Claude, ChatGPT, Claude Code, Cursor, and other automatically registered clients, remove or disconnect Quok in that AI app.
• For an app whose OAuth credentials you created in Quok, open Preferences → Connect an AI app → Connect your own app and choose Revoke. Its access and refresh tokens stop working immediately.
• For a connection key, open Connect your AI, choose Revoke next to the key, then confirm with Revoke key. The app loses access right away.

Note

A connected app acts as you. It sees and changes only what your Quok role allows, and its changes are recorded as yours. Review the details in What the assistant can and can’t access.