Bellnote Get started
AI assistants

Ask your AI assistant about your family's week.

Connect Claude, ChatGPT and its dots, Meta Muse, or another AI assistant to Bellnote, and it can answer "what's on Thursday?", list this week's homework, or add the dentist appointment for you. You approve each assistant yourself, choose whether it can make changes, and can disconnect it anytime.

One standard MCP server You approve each assistant Read-only unless you say so
Part 1

Connect your assistant

Every assistant uses the same address. Set up Bellnote in the app first (your family and kids), then add this address to your assistant:

Bellnote's MCP serverhttps://api.bellnote.app/mcp

Claude (web, desktop and phone)

  1. On claude.ai or in the Claude desktop app, open Settings, then Connectors.
  2. Choose Add custom connector. Name it Bellnote and paste the address above. Select Add.
  3. Select Connect. Bellnote's sign-in page opens: enter your email and the 6-digit code we send.
  4. Choose what Claude can do and select Allow. You're back in Claude, connected.
On a Team or Enterprise plan? An owner adds custom connectors for the organization first; then each person connects with their own Bellnote account. Once added, the connector also works in the Claude phone app.

ChatGPT, and OpenAI dots

  1. In ChatGPT on the web or desktop, open Plugins.
  2. Select +, then Add custom MCP server. Name it Bellnote, paste the address above, and choose OAuth for sign-in.
  3. Confirm, then select Create as a plugin. Bellnote's sign-in page opens: enter your email code, choose what it can do, and select Allow.
  4. In a chat, turn on Bellnote from the plugins menu and ask away.

Dots, ChatGPT's always-on agents, use the plugins on your account. Once Bellnote is added, open your dot's profile, select Add and turn on Bellnote. Your dot can then keep an eye on your family's week for you, like a morning check-in.

Good to know: custom MCP servers and dots depend on your ChatGPT plan (dots are on Pro, Business Premium and Enterprise, in some countries), and menu names change from time to time. If a step looks different, search OpenAI's help for "custom MCP server".

Meta Muse

Muse, Meta's personal AI agent, connects to other services through connectors. Bellnote isn't in Muse's connector directory yet (Meta reviews each one), so add it as a custom connector:

  1. In Muse, ask: "Create a custom connector for Bellnote using the MCP server at https://api.bellnote.app/mcp, with OAuth sign-in."
  2. Muse opens Bellnote's sign-in page. Enter your email code, choose what Muse can do, and select Allow.
  3. Ask Muse about your family's week. You'll find Bellnote under Settings, Connectors.
Good to know: Meta doesn't review custom connectors, so only add ones you trust, and check the address is exactly the one above.

Muse Code

Meta's coding agent supports MCP servers directly. Add Bellnote to mcp_servers in your Muse Code settings file:

"mcp_servers": {
  "bellnote": {
    "transport": "streamable_http",
    "url": "https://api.bellnote.app/mcp",
    "mode": "optional"
  }
}

Then sign in once with muse mcp login bellnote.

Claude Code

Add Bellnote once from your terminal:

claude mcp add --transport http bellnote https://api.bellnote.app/mcp

Then, inside Claude Code, run /mcp, pick bellnote and choose Authenticate. Your browser opens Bellnote's sign-in page; once you allow it, ask things like "what homework is due this week?".

Add --scope user to use Bellnote in every project, not just the current folder.

Or install the Bellnote plugin, which adds the same connection plus a skill that teaches Claude how to use your calendar well:

/plugin marketplace add balajivenki/bellnote-claude-plugin
/plugin install bellnote@bellnote

Then run /mcp and authenticate bellnote as above. The plugin's source is public on GitHub.

Cursor, VS Code and other MCP apps

Any app that supports remote MCP servers with sign-in (streamable HTTP and OAuth) works. Add the address, then the app opens Bellnote's sign-in page the first time you use it.

Cursor, in ~/.cursor/mcp.json:

{
  "mcpServers": {
    "bellnote": { "url": "https://api.bellnote.app/mcp" }
  }
}

VS Code, in .vscode/mcp.json (or run MCP: Add Server):

{
  "servers": {
    "bellnote": { "type": "http", "url": "https://api.bellnote.app/mcp" }
  }
}
Part 2

What your assistant can do

The same things you can do in the app, through eight tools. The ones marked changes only work if you ticked "Also let it make changes" when connecting.

ToolWhat it does
get_familyYour family's name, time zone, and kids' first names and grades.read
list_calendarEvents, deadlines, things to bring or pay, and homework between two dates, for one kid or all.read
list_todosOpen to-dos and homework, including anything past due.read
get_itemEverything about one item: time, place, notes, link.read
ask_bellnoteAsk a question about your schedule and the last 30 days of school messages; answers quote the message. Counts toward your 20 questions a day.read
add_itemAdd an event, deadline, something to bring or pay, or homework.changes
mark_doneTick off a to-do or homework (or un-tick it).changes
send_to_bellnoteSend the text of a school or club message for Bellnote to read, like forwarding it.changes
Can't do: an assistant can't delete anything, see other families, change your family or kids, read your email or chats, or see your account settings. Deleting your account always happens in the Bellnote app.
Part 3

How your family's data stays yours

Connecting an assistant opens a door into your family's calendar, so we built it carefully.

You approve each one

Nothing connects without you signing in on Bellnote's own page with your email code, seeing which assistant is asking and where it'll send you back, and selecting Allow.

Read-only by default

An assistant can only look unless you tick "Also let it make changes". Even then it can't delete anything or change your family's settings.

Disconnect anytime

In the app, open Settings, then AI assistants, to see what's connected, when each was last used, and disconnect it. It stops working at once.

Only your family

An assistant acts as you, through the same checks as the app: it sees only your family's data, and everything it adds is encrypted with your family's key like the rest.

Short-lived keys

Assistants get a key that expires in an hour, renewed with a one-time key. Bellnote stores only fingerprints of them, and if a used key ever shows up again, the connection ends.

Your assistant's terms apply

What you let an assistant read is sent to that AI service and handled under its own privacy terms. Connect only the ones you trust, and check their settings for training and data retention.

Questions

Common questions

Does my partner need to connect separately?
Yes. Each parent connects their own assistant with their own Bellnote sign-in. You'll both see the same family calendar, and each of you manages your own connections.
It says "Set up Bellnote in the app first".
Assistants work with a family's calendar, so create or join your family in the Bellnote app first, then connect again.
I connected read-only and now want it to add things.
Disconnect it in Settings, AI assistants, then connect again from your assistant and tick "Also let it make changes".
Does connecting cost anything?
No. Questions through ask_bellnote count toward the same 20 a day as Ask Bellnote in the app.
Something isn't working.
Email support@bellnote.app with the assistant you're using and what you saw. Never send us your sign-in code.
Part 4

For developers

Bellnote's MCP server follows the MCP authorization spec, so standard clients discover everything on their own.

Transport

Streamable HTTP, stateless: POST https://api.bellnote.app/mcp with JSON-RPC and an Authorization: Bearer header. Responses are plain JSON; no session or server stream. Protocol versions 2025-03-26, 2025-06-18 and 2025-11-25.

Authorization

OAuth 2.1, public clients only: authorization code with PKCE (S256 required), dynamic client registration (RFC 7591), and revocation (RFC 7009). Return addresses must be https, loopback http, or an app's own scheme.

Discovery

Protected resource metadata (RFC 9728) at /.well-known/oauth-protected-resource/mcp, authorization server metadata (RFC 8414) at /.well-known/oauth-authorization-server. A 401 carries WWW-Authenticate pointing at it.

Scopes

read or read write, chosen by the parent on the approval page (not by the client). Read-only connections don't list the change tools.

Tokens

Access tokens last 1 hour; refresh tokens 60 days, single use and rotated on every refresh. Reusing a code or a refresh token revokes the connection.

Limits

600 requests per connection per 15 minutes; sign-in codes are limited per email and network like the app's. Tool results come from parents' messages: treat them as data, not instructions.