Connected Apps

Connect an AI assistant you already use — Claude, ChatGPT, or any tool that supports custom connectors — and log homeschool activities by chatting. Say "log 30 minutes of math with Emma" mid-conversation and it lands in Homeschool Fox automatically.

Connected apps require an active subscription or trial.

Two Ways to Connect

• Sign in to connect — assistants that support Homeschool Fox directly (or any custom connector you add by URL) can connect with a sign-in prompt: click Connect, log in to Homeschool Fox, approve, done. No keys to copy. Manage or disconnect these any time from Settings → Connected apps → Manage connected assistants.
• Personal API key — for tools that ask for a key or URL instead, generate one below.

Adding to Claude

1. In Claude, open Settings → Connectors
2. Click Add custom connector and paste https://homeschoolfox.com/mcp
3. Click Connect, sign in to Homeschool Fox, and approve access

Homeschool Fox now shows up in Claude's connector list. To use it in a chat, turn it on from the tools menu.

Adding to ChatGPT

1. In ChatGPT, open Settings → Apps & Connectors
2. Turn on Developer mode under Advanced settings if you don't see an option to add your own (your ChatGPT plan decides whether it's available)
3. Create a new connector, paste https://homeschoolfox.com/mcp, and choose OAuth for authentication
4. Sign in to Homeschool Fox and approve access

Using a Personal API Key

Some tools can't run the sign-in step and ask for a key or URL instead. For those:

1. Go to Settings
2. Find Connected apps
3. Click Generate API key
4. Copy the Connector URL (and the API key, if you plan to use the API directly)

Copy them right away. For your security, Homeschool Fox shows them only once. If you miss them, click Regenerate for a fresh set.

What You Can Do

Once connected, your assistant can:

• Log activities — "Log an hour of reading with both kids this morning"
• Set up repeating schedules — "Math every Monday and Wednesday at 9 through June"
• Check what's logged — "What did we log this week?"
• Report progress — "How are we doing on hours this school year?"
• Look up your students and subjects — so it logs against the right names
• Add a subject — when you confirm you want one that doesn't exist yet

A few things to know:

• One subject per activity. "We did math and reading" becomes two activities — just like the in-app AI parser.
• Name your students. With more than one student on the account, say who the activity was for. Single-student accounts fill in automatically.
• Subjects come from your account. If the assistant names a subject you don't have, it's told which subjects are available so it can correct itself — and it can create the subject for you if you ask.
• No duplicates. If your assistant retries a request, Homeschool Fox recognizes the repeat and won't log the same activity twice.

Shared Accounts

Each person generates their own key from their own login. A co-parent with full access logs into the shared account like normal; view-only members can read activities and progress but can't log.

Keeping Your Key Safe

Treat the Connector URL and API key like a password — anyone who has them can read and log activities on your account.

• Regenerate issues a new key and immediately revokes the old one. Apps using the old key stop working until you give them the new URL.
• Revoke shuts off access entirely.

For Developers

The same key works as a Bearer token against the REST API:

• POST /api/v1/activities — log an activity (subjects and students by name or id; supports recurrence fields)
• GET /api/v1/activities — recent activities, with from/to date filters
• GET /api/v1/students and GET /api/v1/subjects — what you can log against
• POST /api/v1/subjects — add a subject (returns the existing one on a name match)
• GET /api/v1/progress — per-student hours and attendance vs current school-year goals

Send it as an Authorization: Bearer <key> header. Requests are rate-limited per key.