Orbrey AI — Claude Code plugin

The Orbrey AI plugin for Claude Code gives you ten skills, three agents, and six slash commands that connect directly to your live household data — recipes, pantry, grocery, calendar, tasks, and rewards. Ask Claude to plan a week of dinners, rotate chores fairly, or show what's on today, and it acts by calling Orbrey's API on your behalf.

This article covers the Claude Code plugin specifically. For connecting Claude Desktop, Claude.ai, or ChatGPT via MCP, see Using Orbrey with Claude (MCP).

Installation

In Claude Code, run these two commands in order:

/plugin marketplace add orbrey/orbrey-ai-marketplace
/plugin install orbrey-ai@orbrey-ai-marketplace

Restart Claude Code after installation. The plugin bundles the Orbrey MCP server pointing at https://mcp.orbrey.com/mcp — no manual token paste required.

First-time authentication

The first time you run a skill or slash command, Claude Code will open a browser OAuth flow. Sign in to Orbrey, pick which household to authorise, and click Allow. Claude Code stores the access token securely (system keychain, or ~/.claude/.credentials.json as a fallback) and refreshes it automatically.

If you have already authorised Orbrey in Claude.ai's web settings, you will be asked to authorise once more in Claude Code — the two products use separate token stores. After the first flow, you will not be asked again.

Slash commands

Six one-liners for the most common household tasks. Each runs the matching skill with sensible defaults.

Skills

Skills are named capabilities you invoke with natural language or as arguments to a slash command. They always call the live MCP tools first — nothing is invented.

• meal-planner — Generate a 7/14/28-day meal plan respecting dietary tags, household size, calendar busy-nights, and pantry stock. Auto-syncs missing ingredients to the grocery list.
• grocery-organizer — Dedupe, categorise, and aisle-order the list; fold duplicates via grocery.merge.
• chore-rotator — Generate a fair chore rotation weighted by effort and age, tied to the rewards system.
• routine-builder — Build morning, school-prep, or bedtime routines as cascading recurring task occurrences.
• calendar-conflict-finder — Flag overlaps, drive-time gaps, double-booked attendees, and orphaned events across all members.
• family-week-planner — Combined weekly view: meals, chores, appointments, school events, and reminders.
• reward-strategist — Design a reward catalogue; balance allowance vs chore credits; project wallet trajectories 4–12 weeks out.
• pantry-to-recipe — Suggest recipes that minimise new grocery purchases by using what is already on the shelf.
• household-onboarder — Walk a new member through profile, role, dietary preferences, calendar OAuth, and allowance setup.
• recurring-task-author — Translate natural-language schedules ("every other Tuesday except school holidays") into RRule patterns.

Calling a skill

/orbrey-ai:meal-planner plan 7 days, Maya dislikes fish
/orbrey-ai:calendar-conflict-finder next 14 days
/orbrey-ai:routine-builder bedtime routine for 6 year old

If a skill needs more context it will ask. All skills accept $ARGUMENTS for fast one-liner invocation.

Agents

Agents coordinate multiple skills and tool calls in sequence. They are designed for work that takes more than a single step.

• household-curator — Long-running weekly auditor: stale tasks, expired pantry, unbalanced chore loads, unused recipes, calendar conflicts. Run it on a Sunday evening to start the week clean.
• meal-plan-orchestrator — Coordinates the meal-planner ↔ pantry ↔ grocery ↔ calendar handshake. Invoked automatically by the meal-planner skill for complex constraint solving.
• routine-coach — Real-time helper for morning or bedtime routines. Ticks tasks done and credits gems as steps are completed in conversation.

Safety hooks

The plugin ships two built-in safety hooks:

• confirm-destructive — Before any delete, merge, or wallet adjustment, Claude Code surfaces a summary of what is about to change and waits for your confirmation.
• suggest-meal-slot — After a new recipe is created, suggests slotting it into the next open day in the meal plan.

Plus-tier features

The pantry and meal-planning tools require an Orbrey Plus subscription on the authorised household. All other skills and commands work on the free plan.

Disconnecting

Uninstall the plugin in Claude Code with /plugin uninstall orbrey-ai@orbrey-ai-marketplace, then revoke the OAuth grant from Settings → Integrations in the Orbrey app. Revoking the grant stops all further tool calls immediately.