How do I use paprika-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@paprika-mcp Show me the ingredients for my lasagna recipe" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

This server cannot be installed

A

license - permissive license

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

paprika-mcp