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.
Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDo publicador
Connect Bobbeori food-management tools to ChatGPT, Codex, Claude, and other MCP clients with OAuth and preview-first write actions.
MCP server for Bobbeori, connecting ChatGPT, Codex, Claude, and external agents to fridge inventory, recipes, shopping, receipts, and calendar tools with OAuth and preview-first write actions.
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
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
Bobbeori write tools are preview-first.
*.preview tool.confirmation_token unchanged to *.commit, *.save, or *.create.Never invent a user_id; OAuth supplies the account.
Inventory writes mirror the production Bobbeori MCP behavior:
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.
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.
$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
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.
See SECURITY.md. Do not put OAuth client secrets, API keys, user receipt data, or production .env files in this repository.
See CONTRIBUTING.md.
MIT. See LICENSE.
MCP server for Bobbeori, connecting ChatGPT, Codex, Claude, and external agents to fridge inventory, recipes, shopping, receipts, and calendar tools with OAuth and preview-first write actions.
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Bobbeori roda localmente via stdio.
Última verificação: 2026-10-28. MCP server for Bobbeori, connecting ChatGPT, Codex, Claude, and external agents to fridge inventory, recipes, shopping, receipts, and calendar tools with OAuth and preview-first write actions.