paprika-3-mcp

By soggycactus GitHub

MCP Server for creating/editing recipes in Paprika 3 with natural language

Overview

What is Paprika 3 MCP?

Paprika 3 MCP is a server that allows users to create and edit recipes in the Paprika 3 app using natural language processing. It exposes recipes as LLM-readable resources, enabling integration with language models like Claude.

How to use Paprika 3 MCP?

To use Paprika 3 MCP, install the server on your system, configure it with your Paprika 3 credentials, and connect it to an LLM client like Claude to create or update recipes.

Key features of Paprika 3 MCP?

Allows creation and modification of recipes using natural language.
Supports recipe photos and structured logging.
Easy installation and setup for various operating systems.

Use cases of Paprika 3 MCP?

Automating recipe management in the Paprika app.
Enhancing user experience by allowing voice commands to create or edit recipes.
Integrating with AI tools for personalized recipe suggestions.

FAQ from Paprika 3 MCP?

What systems are supported?

Paprika 3 MCP can be installed on Mac, Linux, or Windows systems.

Is there a cost to use Paprika 3 MCP?

No, Paprika 3 MCP is open source and free to use under the MIT License.

How do I check if the installation was successful?

You can verify the installation by running paprika-3-mcp --version in your terminal.

Content

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

Go to the latest release.
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
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.
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

🗂 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 System	Log 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.

No tools information available.

No content found.