Connect Koriander to AI assistants

Koriander has a built-in MCP server that lets AI assistants like Claude manage your recipes, meal plans, shopping lists, and more on your behalf.

Claude Desktop & claude.ai

Connect via the built-in Connectors UI. No tokens or config files needed.

  1. 1 Open Settings (or Customize) and go to Connectors.
  2. 2 Click Add custom connector and enter this URL:
https://koriander.app/mcp
  1. 3 Click Add. A browser window will open asking you to log in to Koriander and authorize the connection.
  2. 4 Click Authorize. You'll be redirected back and the connector is ready to use.

Access tokens expire after 1 hour and are automatically refreshed. Available on Pro, Max, Team, and Enterprise plans.

Claude Code & other MCP clients

Use a personal access token for direct API access.

  1. 1 Go to Settings > API Tokens and create a token.
  2. 2 Copy the token and add this to your MCP client config: 
{
  "mcpServers": {
    "koriander": {
      "url": "https://koriander.app/mcp",
      "headers": {
        "Authorization": "Bearer kor_your_token_here"
      }
    }
  }
}

In Claude Code, you can also run /mcp and add it interactively.

What can the AI do?

Once connected, the AI assistant can:

Search and browse your recipes
Create and edit recipes
View recipe ingredients and nutrition
Plan meals on specific dates
Mark meals as cooked
Manage shopping lists and items
Add recipe ingredients to shopping lists
Organize recipes into collections
Log meals and view nutrition diary
Search the ingredient database

Questions

Is my data safe?

The AI assistant only accesses your data through the same authorization you use in the app. OAuth tokens expire after 1 hour. Personal access tokens can be revoked at any time from your settings.

Does this use my AI credits?

No. The MCP connection lets the AI read and manage your existing data. It doesn't use Koriander's AI features (scanning, generation, conversations), so no credits are consumed.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to apps and services. It's how Claude and other AI tools can interact with Koriander on your behalf.

Can I use this with other AI assistants?

Yes. Any MCP-compatible client can connect using a personal access token. The OAuth flow is currently optimized for Claude, but the token-based approach works with any client.

Can the AI delete my recipes?

It has access to delete recipes you own, just like you can in the app. Claude will typically ask for confirmation before destructive actions. You can revoke access at any time.