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           # full recipe details
paprika recipes upsertRecipe        # 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