Paprika

Tools for interacting with the Paprika Recipe Manager.

	What it is
`openapi.yaml`	OpenAPI 3.0.3 spec — machine-readable definition of the unofficial Paprika API
`paprika/`	Go CLI — resource-grouped commands with table + JSON output and shell completions
`paprika_mcp/`	Python FastMCP server — exposes Paprika data as MCP tools for AI agents

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 you@example.com --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 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

Command	Description
`paprika-mcp setup`	Interactive credential and port setup
`paprika-mcp run`	Run the MCP server in the foreground
`paprika-mcp install`	Install as a macOS LaunchAgent (background service)
`paprika-mcp uninstall`	Remove the LaunchAgent
`paprika-mcp update`	Pull latest changes, reinstall, and restart the LaunchAgent
`paprika-mcp status`	Check LaunchAgent status
`paprika-mcp logs`	View server logs

Available Tools

Tool	Description
`get_sync_status`	Get change counters for all resource types
`list_recipes`	List all recipes as lightweight `{uid, hash}` pairs
`get_recipe(uid)`	Get full recipe details by UID
`list_categories`	List all recipe categories
`list_grocery_lists`	List all grocery lists
`list_grocery_items(list_uid, include_checked?)`	List grocery items for a specific list
`list_meal_plans(start_date?, end_date?)`	List meal plan entries, optionally filtered by date
`get_meals_for_date(date)`	Get meal plan entries for a specific date
`add_grocery_item(list_uid, name, ...)`	Add a grocery item to a specific list

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_item is the only write tool
The Paprika API is unofficial and undocumented; see API_REFERENCE.md for 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

paprika-mcp