Paprika
Tools for interacting with the Paprika Recipe Manager.
CLI
Install
Build from source (requires Go 1.21+):
git clone https://github.com/aarons22/paprika-tools
cd paprika-tools/paprika
go build -o paprika .
mv paprika /usr/local/bin/
go install (once the repo is tagged):
go install github.com/aarons22/paprika-tools/paprika@latest
Authenticate
paprika account login --email [email protected] --password yourpassword
The token is saved automatically to ~/.config/paprika/config.yaml (mode 0600). All subsequent commands read it from there — no manual copy-paste required.
The token is also accepted via the PAPRIKA_TOKEN environment variable.
Commands
paprika account login # authenticate and get a Bearer token
paprika recipes listRecipes # all recipes as {uid, hash} pairs
paprika recipes getRecipe <uid> # full recipe details
paprika recipes upsertRecipe <uid> # create or update a recipe (gzip multipart)
paprika categories listCategories # all recipe categories
paprika grocerylists listGroceryLists # all grocery lists
paprika groceries listGroceryItems # all grocery items across all lists
paprika groceries createGroceryItems # add or update grocery items (gzip multipart)
paprika meals listMealPlans # full meal calendar
paprika meals createMealPlans # add or update meal plan entries (gzip multipart)
paprika pantry listPantryItems # pantry inventory
paprika status getSyncStatus # change counters for all resource types
Output & global flags
# Raw JSON (pipe-friendly)
paprika recipes listRecipes --json | jq '.[].uid'
# Override API base URL
paprika recipes listRecipes --base-url https://www.paprikaapp.com/api/v2/sync
# Disable colour
paprika recipes listRecipes --no-color
# Shell completions (bash, zsh, or fish)
paprika completion bash >> ~/.bashrc
MCP Server
FastMCP server that exposes Paprika data as tools for AI agents (Claude, Cursor, etc.).
Quick Install (macOS)
curl -sSL https://raw.githubusercontent.com/aarons22/paprika-tools/main/install.sh | bash
Then run:
paprika-mcp setup
paprika-mcp install
If paprika-mcp isn't on your PATH, use:
$HOME/.local/bin/paprika-mcp --help
CLI Commands
Available Tools
Config & Logs
- Config:
~/Library/Application Support/paprika-mcp/config.toml - Token cache:
~/Library/Application Support/paprika-mcp/.paprika_token.json - Stdout log:
~/Library/Logs/paprika-mcp.out.log - Stderr log:
~/Library/Logs/paprika-mcp.err.log
Notes
- Mostly read-only;
add_grocery_itemis the only write tool - The Paprika API is unofficial and undocumented; see
API_REFERENCE.mdfor details - Tokens are cached on disk and refreshed automatically on 401
OpenAPI Spec
openapi.yaml is the authoritative machine-readable definition of the Paprika API. It covers authentication, recipes, categories, grocery lists and items, meal plans, pantry, and sync status.
Use it with any OpenAPI-compatible tooling — code generators, HTTP clients, documentation renderers, or to regenerate the CLI:
go install github.com/theaiteam-dev/commandspec@latest
commandspec validate --schema ./openapi.yaml
commandspec init --schema ./openapi.yaml --name paprika --output-dir ./paprika