paprika-3-mcp

paprika-3-mcp

1
entertainment_and_media

The Paprika 3 MCP is an open source server that allows language models to interact with and manage recipes in the Paprika application. It uses MCP protocol to facilitate recipe creation and updates, enhancing recipe accessibility and management.

paprika-3-mcp

A Model Context Protocol (MCP) server that exposes your Paprika 3 recipes as LLM-readable resources — and lets an LLM like Claude create or update recipes in your Paprika app.

🖼️ Example: Claude using the Paprika MCP server

MCP server running with Claude

🚀 Features

See anything missing? Open an issue on this repo to request a feature!

📄 Resources
  • Recipes ✅
  • Recipe Photos 🚧
🛠 Tools
  • create_paprika_recipe
    Allows Claude to save a new recipe to your Paprika app
  • update_paprika_recipe
    Allows Claude to modify an existing recipe

⚙️ Prerequisites

  • ✅ A Mac, Linux, or Windows system
  • ✅ Paprika 3 installed with cloud sync enabled
  • ✅ Your Paprika 3 username and password
  • ✅ Claude or any LLM client with MCP tool support enabled

🛠 Installation

You can download a prebuilt binary from the Releases page.

🍎 macOS (via Homebrew)

If you're on macOS, the easiest way to install is with Homebrew:

brew tap soggycactus/tap
brew install paprika-3-mcp

🐧 Linux / 🪟 Windows

  1. Go to the latest release.

  2. Download the appropriate archive for your operating system and architecture:

    • paprika-3-mcp_<version>_linux_amd64.zip for Linux
    • paprika-3-mcp_<version>_windows_amd64.zip for Windows

  3. Extract the zip archive:

    • Linux: 
      unzip paprika-3-mcp_<version>_<os>_<arch>.zip
    • Windows:
      • Right-click the .zip file and select Extract All, or use a tool like 7-Zip.

  4. Move the binary to a directory in your system's $PATH:

    • Linux:

      sudo mv paprika-3-mcp /usr/local/bin/

    • Windows:

      • Move paprika-3-mcp.exe to any folder in your PATH (e.g., %USERPROFILE%\bin)

✅ Test the installation

You can verify the server is installed by checking:

paprika-3-mcp --version

You should see:

paprika-3-mcp version v0.1.0

🤖 Setting up Claude

If you haven't setup MCP before, first read more about how to install Claude Desktop client & configure an MCP server.

To add paprika-3-mcp to Claude, all you need to do is create another entry in the mcpServers section of your claude_desktop_config.json file:

{
  "mcpServers": {
    "paprika-3": {
      "command": "paprika-3-mcp",
      "args": [
        "--username",
        "<your paprika 3 username (usually email)>",
        "--password",
        "<your paprika 3 password>"
      ]
    }
  }
}

Restart Claude and you should see the MCP server tools after clicking on the hammerhead icon:

MCP server running with Claude

📄 License

This project is open source under the © 2025 Lucas Stephens.

🗂 Miscellaneous
📄 Where can I see the server logs?

The MCP server writes structured logs using Go’s slog with rotation via lumberjack. Log files are automatically created based on your operating system:

Operating SystemLog File Path
macOS~/Library/Logs/paprika-3-mcp/server.log
Linux/var/log/paprika-3-mcp/server.log
Windows%APPDATA%\paprika-3-mcp\server.log
Other / Unknown/tmp/paprika-3-mcp/server.log

💡 Logs are rotated automatically at 100MB, with only 5 backup files kept. Logs are also wiped after 10 days.