Bobbeori MCP Server
Connect Bobbeori food-management tools to ChatGPT, Codex, Claude, and other MCP clients with OAuth and preview-first write actions.
What you can do
- View refrigerator inventory and expiring ingredients.
- Preview and add, update, or remove refrigerator ingredients.
- Recommend recipes from ingredients you already have.
- Look up food storage, handling, and nutrition guidance.
- Preview and save shopping lists.
- Preview and stock reviewed receipt items.
- Preview and create Google Calendar events or reminders.
Quick start
git clone https://github.com/Bobbeori/bobbeori-mcp-server.git
cd bobbeori-mcp-server
python -m venv .venv
source .venv/bin/activate
pip install -e .
cp .env.example .env
uvicorn bobbeori_mcp.server:app --host 0.0.0.0 --port 8001
Windows PowerShell:
git clone https://github.com/Bobbeori/bobbeori-mcp-server.git
cd bobbeori-mcp-server
py -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e .
copy .env.example .env
uvicorn bobbeori_mcp.server:app --host 0.0.0.0 --port 8001
Docker:
docker build -t bobbeori-mcp-server .
docker run --env-file .env -p 8001:8001 bobbeori-mcp-server
Connect an MCP client
Production MCP URL:
https://mcp.bobbeori.com/mcp
OAuth resource:
https://mcp.bobbeori.com
Codex CLI:
codex mcp add bobbeori `
--url https://mcp.bobbeori.com/mcp `
--oauth-client-id 3nu2uqh1ir8d10ljocufuj2qv1 `
--oauth-resource https://mcp.bobbeori.com
codex mcp login bobbeori --scopes bobbeori-mcp/inventory.read,bobbeori-mcp/inventory.write,bobbeori-mcp/recipe.read,bobbeori-mcp/guide.read,bobbeori-mcp/receipt.write,bobbeori-mcp/shopping.write,bobbeori-mcp/calendar.write
Claude Desktop-style remote server config:
{
"mcpServers": {
"bobbeori": {
"url": "https://mcp.bobbeori.com/mcp"
}
}
}
For ChatGPT, create a connector/plugin with:
MCP Server URL: https://mcp.bobbeori.com/mcp
Authentication: OAuth
Resource: https://mcp.bobbeori.com
Example prompts
- "Show my Bobbeori refrigerator ingredients that expire this week."
- "Recommend dinner recipes using ingredients I already have."
- "Preview adding these receipt items to my refrigerator."
- "Create a shopping list for missing ingredients from recipe 175."
- "Preview a calendar reminder to use tofu tomorrow at 9 AM KST."
Tools
Write safety
Bobbeori write tools are preview-first.
- Call the matching
*.previewtool. - Show the preview and warnings to the user.
- Ask for explicit confirmation.
- Pass the returned
confirmation_tokenunchanged to*.commit,*.save, or*.create.
Never invent a user_id; OAuth supplies the account.
Inventory writes mirror the production Bobbeori MCP behavior:
- Add accepts 1-50 items, validates ingredient names, resolves storage rules, and calculates missing expiration dates before confirmation.
- Update accepts 1-50 partial changes, shows before/after values, and rejects the confirmed action if any selected item changed after preview.
- Remove accepts 1-100 active inventory IDs and marks the items inactive.
- Each confirmed batch is atomic. Retrying the same confirmation returns the original result and does not apply the mutation twice.
The production service implements these tools inside its backend by calling the inventory domain service directly. It does not require additional public REST endpoints for inventory writes.
Environment
Required production values:
BOBBEORI_API_BASE_URL=https://api.bobbeori.com
BOBBEORI_MCP_API_PREFIX=/api/v1/mcp
MCP_ISSUER_URL=
MCP_RESOURCE_URL=https://mcp.bobbeori.com
MCP_JWKS_URL=
MCP_JWT_AUDIENCE=https://mcp.bobbeori.com
MCP_PREVIEW_TOKEN_SECRET=
See .env.example for all options.
Smoke test
$env:MCP_ACCESS_TOKEN="<oauth-access-token>"
py scripts/test_mcp_oauth.py `
--mcp-url https://mcp.bobbeori.com/mcp `
--resource-url https://mcp.bobbeori.com
Development
pip install -e .
pytest -q
This repository owns the external MCP boundary. Product logic, OCR, database access, recipe search, shopping persistence, and calendar persistence live in the main Bobbeori backend.
See docs/bridge-api.md for the backend bridge contract.
Security
See SECURITY.md. Do not put OAuth client secrets, API keys, user receipt data, or production .env files in this repository.
Contributing
See CONTRIBUTING.md.
License
MIT. See LICENSE.