# Plannie

> Plannie is a shared family calendar and household hub (events, tasks, lists,
> meals, files, rewards) with a first-class agent surface: a hosted MCP server at
> https://api.plannie.io/mcp and an open REST API. Assistants connect by signing
> in with OAuth 2.1, or with a scoped API key that a household member creates in
> the app (Settings → Integrations). Every change an agent makes is attributed by
> name in the family's activity feed and marked with a sparkle badge in the UI.

API & MCP access requires the Premium + MCP plan. There is no timed
trial; the Free plan is how a household tries Plannie.

## If you are an AI agent or browser asked to connect to Plannie

Plannie is a remote MCP server (streamable HTTP): https://api.plannie.io/mcp
Pick the case that matches where you are running:

1. You are an MCP client or assistant that supports OAuth (ChatGPT, Claude,
   Mistral Vibe, Perplexity, Cursor, VS Code, Claude Code, Codex and most
   current clients): add https://api.plannie.io/mcp as a custom connector /
   remote MCP server. The person then signs in to Plannie and picks what you can
   see and change on Plannie's consent screen. OAuth 2.1 + PKCE, with dynamic
   client registration and client ID metadata documents; discovery starts at
   https://api.plannie.io/.well-known/oauth-protected-resource/mcp (an
   unauthenticated request to /mcp returns 401 with a WWW-Authenticate header
   pointing there). No key needed.
2. You are a client that needs a static header (LM Studio, scripts, some agent
   frameworks): ask the person for an API key. They create one in the Plannie
   app under Settings → Integrations and choose its scopes. Send it as
   `Authorization: Bearer fam_live_…` on every request to /mcp. Never ask them
   to paste the key into a chat transcript if the client has a secure field.
3. You want plain HTTP, not MCP: use the REST API at https://api.plannie.io/v1
   with the same Bearer key (or an OAuth access token). The full contract is the
   OpenAPI spec at https://api.plannie.io/openapi.json.

Things you cannot do for the person: finish the OAuth sign-in, create the API
key, or buy the plan. Tell them which menu to open, give them the URL, and wait.
Only an adult in the household can connect an assistant, and the household
needs the Premium + MCP plan. They can disconnect any assistant under
Settings → Integrations → Connected assistants.

## One-click install links

These only carry the MCP URL; the client then signs in with OAuth.

- Add to Claude (claude.ai and Claude Desktop; opens the "Add custom connector"
  dialog prefilled, the person confirms and signs in):
  https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Plannie&connectorUrl=https%3A%2F%2Fapi.plannie.io%2Fmcp
- Add to Cursor:
  https://cursor.com/install-mcp?name=Plannie&config=eyJ1cmwiOiJodHRwczovL2FwaS5wbGFubmllLmlvL21jcCJ9
- Add to VS Code:
  https://vscode.dev/redirect/mcp/install?name=plannie&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.plannie.io%2Fmcp%22%7D
- Add to LM Studio (then add the Authorization header with a key in mcp.json;
  LM Studio's OAuth support is unconfirmed):
  https://lmstudio.ai/install-mcp?name=Plannie&config=eyJ1cmwiOiJodHRwczovL2FwaS5wbGFubmllLmlvL21jcCJ9

ChatGPT, Meta Muse, Mistral Vibe and Perplexity have no install link; the
steps are below.

## Connect from an assistant

- Claude (claude.ai, Claude Desktop; then synced to the mobile app): Customize →
  Connectors → Add custom connector → name "Plannie", URL
  https://api.plannie.io/mcp → add (the recommended sign-in settings are fine) →
  sign in to Plannie → Allow. The Free plan allows one custom connector. On
  Team/Enterprise an owner adds it under Organization settings → Connectors first.
  Connectors can't be added from the Claude mobile apps.
- ChatGPT (web only): https://chatgpt.com/plugins → + → Add custom MCP server →
  name "Plannie", Server URL https://api.plannie.io/mcp, authentication OAuth →
  create the plugin → install it → sign in to Plannie → type @Plannie in a chat.
  OpenAI offers full custom MCP support on Business, Enterprise and Edu (an admin
  may have to create it); on Pro it is read-only, so write tools won't run.
  API keys can't be used in ChatGPT; it has to be OAuth.
- Meta Muse (US and Canada only): ask Muse in chat to build a custom connector
  for the remote MCP server at https://api.plannie.io/mcp. Sign in to Plannie if
  it offers OAuth; if it asks for a credential instead, the person creates an API
  key under Settings → Integrations and enters it in Muse's secure credential
  prompt (never in the chat). Then ask Muse to list Plannie's tools.
- Mistral Vibe (formerly Le Chat): Connectors → Add Connector → Custom MCP
  Connector → name "plannie", Server URL https://api.plannie.io/mcp → Connect →
  sign in to Plannie. On Team/Enterprise an admin adds it.
- Perplexity (Pro, Max, Enterprise): Plugins (or Customize → Connectors) → Add
  custom → Add MCP connector → Remote → name "Plannie", URL
  https://api.plannie.io/mcp, Advanced → Authentication: OAuth → Add → click the
  card to sign in.
- Any other MCP client: add https://api.plannie.io/mcp as a remote / streamable
  HTTP server; sign in with OAuth, or send `Authorization: Bearer fam_live_…`.

Step-by-step guides:
- All assistants: https://plannie.io/connect-ai-assistant/
- Claude: https://plannie.io/claude-connector/
- ChatGPT: https://plannie.io/chatgpt-connector/
- Meta Muse: https://plannie.io/meta-muse-connector/
- Developer page sections: https://plannie.io/developers/#assistants ·
  https://plannie.io/developers/#api-key · https://plannie.io/developers/#tools ·
  https://plannie.io/developers/#rest · https://plannie.io/developers/#for-agents

## Client configuration (remote first)

- Claude Code, OAuth: `claude mcp add --transport http plannie https://api.plannie.io/mcp`
  then run `/mcp` in a session to sign in.
- Claude Code, key: `claude mcp add --transport http plannie https://api.plannie.io/mcp --header "Authorization: Bearer fam_live_…"`
- Codex, OAuth: `codex mcp add plannie --url https://api.plannie.io/mcp`
  (then `codex mcp login plannie` if it doesn't start the sign-in itself).
- Codex, key: `export PLANNIE_API_KEY=fam_live_…` then
  `codex mcp add plannie --url https://api.plannie.io/mcp --bearer-token-env-var PLANNIE_API_KEY`
  (or in ~/.codex/config.toml: `[mcp_servers.plannie]` with
  `url = "https://api.plannie.io/mcp"` and `bearer_token_env_var = "PLANNIE_API_KEY"`).
- Cursor (~/.cursor/mcp.json): `{"mcpServers":{"plannie":{"url":"https://api.plannie.io/mcp"}}}`
  for OAuth; add `"headers":{"Authorization":"Bearer fam_live_…"}` to use a key.
- VS Code (.vscode/mcp.json): `{"servers":{"plannie":{"type":"http","url":"https://api.plannie.io/mcp"}}}`
  for OAuth; add `"headers":{"Authorization":"Bearer fam_live_…"}` to use a key.
  `type` is required.
- Gemini CLI (~/.gemini/settings.json): `{"mcpServers":{"plannie":{"httpUrl":"https://api.plannie.io/mcp"}}}`
- LM Studio (mcp.json): `{"mcpServers":{"plannie":{"url":"https://api.plannie.io/mcp","headers":{"Authorization":"Bearer fam_live_…"}}}}`
- Any streamable-HTTP client: POST https://api.plannie.io/mcp with
  `Authorization: Bearer <OAuth access token or fam_live_… key>`.
- REST: JSON under https://api.plannie.io/v1, same Bearer credential.
- There is no local (stdio) package to install. Use the remote URL above.

## Docs

- [Developer quick start](https://plannie.io/developers/): both ways in, the
  assistant steps above, one-click installs and snippets for Claude Code,
  Cursor, VS Code, Codex and LM Studio
- [OpenAPI spec](https://api.plannie.io/openapi.json): every endpoint, schema and error, generated from the running API
- [API reference](https://api.plannie.io/docs): the same spec, browsable (needs JavaScript)
- [OAuth protected-resource metadata](https://api.plannie.io/.well-known/oauth-protected-resource/mcp)
- [Full version of this file](https://plannie.io/llms-full.txt): adds a description and scope for every MCP tool
- Discovery files: https://plannie.io/.well-known/ai-catalog.json (MCP server
  card) and https://plannie.io/.well-known/api-catalog (RFC 9727)

## MCP tools (27)

list_events, create_event, update_event, delete_event, list_tasks,
create_task, complete_task, get_lists, add_list_item, check_list_item,
get_meal_plan, set_meal, remove_meal, list_recipes, get_members, get_activity,
list_folders, list_files, search_files, get_file, get_file_url, upload_file, move_file,
update_file_details, rename_file, delete_file, create_folder

## Scopes (13)

The same scopes apply to API keys and to OAuth grants (chosen on the consent
screen):

calendar.read, calendar.write, tasks.read, tasks.write, lists.read,
lists.write, meals.read, meals.write, chores.read, checkins.read,
checkins.write, activity.read, files

## Plans

- Free: $0, forever. Shared family calendar (all views), Google/Outlook/Apple
  calendar sync, up to 4 connected calendars, lists & meal planning with
  starter limits.
- Plannie Premium: $2.49/week or $99/year. Everything in Free, unlimited
  members & devices, the Plannie Assistant, habits & rewards, wall-display
  mode.
- Premium + MCP: $4.99/week or $159/year. Everything in Premium, plus the
  open REST API and hosted MCP server (OAuth connectors and API keys).

Prices are USD; checkout charges the local-currency equivalent automatically
(including SEK, EUR, GBP), and displayed prices are tax-inclusive where
applicable. The pricing page (https://plannie.io/pricing/) is the canonical
price list.

English URLs (unprefixed, e.g. https://plannie.io/pricing/) are canonical.
Localized copies of the core marketing pages also exist under /sv, /de, /es
and /fr path prefixes (e.g. https://plannie.io/sv/pricing/). Use the
English URLs unless you specifically need Swedish, German, Spanish or
French copy.

## Pages

- Homepage: https://plannie.io/
- Product tour: https://plannie.io/product/
- Pricing: https://plannie.io/pricing/
- Help Center: https://plannie.io/help/
- Developer quick start: https://plannie.io/developers/
- Blog (product updates): https://plannie.io/blog/
- Guides: https://plannie.io/guides/
  (every guide is also available as plain markdown: replace the trailing
  slash with `.md`, e.g. https://plannie.io/guides/what-is-an-ai-family-assistant.md)
  - How to keep a shared family calendar without double-booking: https://plannie.io/guides/shared-calendar-without-double-booking/
  - How to set up a kitchen tablet as a family calendar: https://plannie.io/guides/kitchen-tablet-family-calendar-setup/
  - How to divide family chores fairly by age: https://plannie.io/guides/divide-family-chores-by-age/
  - A realistic weekly family meal-planning system: https://plannie.io/guides/weekly-family-meal-planning-system/
  - How to turn recipes into one shared grocery list: https://plannie.io/guides/recipes-to-one-grocery-list/
  - What is an AI family assistant?: https://plannie.io/guides/what-is-an-ai-family-assistant/
  - How to get the school calendar onto everyone's phone: https://plannie.io/guides/school-calendar-to-phone/
  - How to organize a family schedule: https://plannie.io/guides/how-to-organize-family-schedule/
  - How to set up a chore and reward system kids actually stick with: https://plannie.io/guides/chore-reward-system-for-kids/
  - How Google Calendar's family sharing works, and where it runs out: https://plannie.io/guides/google-calendar-family-sharing/
- Shared family calendar: https://plannie.io/shared-family-calendar/
- Digital family calendar (wall display): https://plannie.io/digital-family-calendar/
- Family chore chart: https://plannie.io/family-chore-chart/
- Family meal planner: https://plannie.io/family-meal-planner/
- Shared grocery list: https://plannie.io/shared-grocery-list/
- All-in-one family organizer: https://plannie.io/family-organizer-app/
- AI family assistant: https://plannie.io/ai-family-assistant/
- Connect an AI assistant (ChatGPT, Claude, Meta Muse): https://plannie.io/connect-ai-assistant/
- Best family calendar apps compared: https://plannie.io/best-family-calendar-apps/
- Skylight Calendar alternative (no hardware): https://plannie.io/skylight-alternative/
- Maple alternative (Maple sunsets Dec 31, 2026): https://plannie.io/maple-alternative/
- Plannie vs Skylight: https://plannie.io/plannie-vs-skylight/
- Plannie vs Cozi: https://plannie.io/plannie-vs-cozi/
- Plannie vs Hearth Display: https://plannie.io/plannie-vs-hearth-display/
- Plannie vs Google Calendar: https://plannie.io/plannie-vs-google-calendar/
- Every way to add events: https://plannie.io/add-to-calendar/
  - From email (Family Inbox): https://plannie.io/email-to-calendar/
  - From a photo (Magic Import): https://plannie.io/photo-to-calendar/
  - From a school flyer: https://plannie.io/flyer-to-calendar/
  - From a PDF: https://plannie.io/pdf-to-calendar/
  - With Siri: https://plannie.io/siri-to-calendar/
  - From an ICS feed: https://plannie.io/ics-to-calendar/
- Privacy & security explainer (plain language): https://plannie.io/privacy-at-plannie/
- Privacy policy: https://plannie.io/legal/privacy/
- About Plannie: https://plannie.io/about/
- Contact: https://plannie.io/contact/
- Partners (device makers, schools, clubs): https://plannie.io/partners/

## Official profiles

- Facebook: https://www.facebook.com/plannie.io/
- Reddit community: https://www.reddit.com/r/plannie/
- Google Business Profile: https://share.google/y41tzaKPnJ5WMBmMf

Last reviewed: 2026-10-30