Ask your own recipes a question.

RecipeJam speaks MCP, the protocol AI apps use to reach the things you already own. Connect it once and ChatGPT, Claude or your editor can search your recipes, write new ones down and build a shopping list — working on your collection, not on the internet's.

The address

One address, for every app. It is the same for everyone — what makes it yours is signing in when the app asks.

Connector URL

https://recipejam.com/mcp

There is no key to paste and no token to keep secret. The app opens RecipeJam in a browser, you sign in and approve it, and it is connected. You can see what you have connected — and cut any of it off — under Tokens and connections.

Setting it up

Pick the app you use. Everything below is the same connection; only the place you paste it changes.

Claude

Web, desktop and mobile

1
Open Settings, then Connectors.
2
Choose Add custom connector.
3
Paste the address and give it a name.
```
https://recipejam.com/mcp
```
4
Claude opens RecipeJam. Sign in, read what it is asking for, and choose Connect.

ChatGPT

Web and desktop

1
Open Settings, then Connectors, and create a new one.
2
Give it the address. Leave the authentication set to OAuth — there is no API key to enter.
```
https://recipejam.com/mcp
```
3
Sign in to RecipeJam when it asks, and approve the connection.

Claude Code

One command, then /mcp to sign in.

terminal

claude mcp add --transport http recipejam https://recipejam.com/mcp

Then run /mcp inside Claude Code and choose to authenticate. It opens a browser, and the sign-in comes back to your own machine.

Cursor

~/.cursor/mcp.json for everything, or .cursor/mcp.json inside one project.

mcp.json

{
    "mcpServers": {
        "recipejam": {
            "url": "https://recipejam.com/mcp"
        }
    }
}

VS Code

.vscode/mcp.json in your workspace. The servers key and the type are both required — leave the type out and VS Code tries to run the address as a command.

mcp.json

{
    "servers": {
        "recipejam": {
            "type": "http",
            "url": "https://recipejam.com/mcp"
        }
    }
}

Windsurf

~/.codeium/windsurf/mcp_config.json. Windsurf calls the field serverUrl, not url.

mcp_config.json

{
    "mcpServers": {
        "recipejam": {
            "serverUrl": "https://recipejam.com/mcp"
        }
    }
}

Anything else

Any client that supports remote MCP servers over HTTP will work: give it the address and let it handle the sign-in. To look at the connection itself — every tool, every argument, the raw responses — the MCP Inspector is the quickest way in.

terminal

npx @modelcontextprotocol/inspector

What it can do

21 tools. You will never name one — you ask for what you want and the app picks — but this is the whole of what a connected app can reach.

search-recipes Find recipes by ingredient or by name. Every term has to match, and it knows synonyms — aubergine finds eggplant.
get-recipe Read one recipe in full: ingredients as written, prep, method, timings.
create-recipe Save a new recipe. The AI reads whatever you pasted and fills in the fields.
update-recipe Change a recipe you already have.
delete-recipe Move one to the wastebasket, where you can restore it for a month. It has to send the recipe's name back as a check, so it cannot delete the wrong one by mistaking an id.
import-recipe Save a recipe from a web page, keeping the photograph and the credit.
list-collections See your collections and how big they are.
create-collection Start a collection, optionally filling it in the same breath.
update-collection Rename one, or publish it so anyone with the link can read it.
delete-collection Delete an empty collection. One with recipes in it is refused — the recipes are never deleted by this.
add-to-collection File a recipe into one.
remove-from-collection Take a recipe back out. The recipe itself is untouched.
shopping-list One combined list for a whole collection, with repeated ingredients added up.
list-books See the books you have made, and whether each is built and up to date.
create-book Bind a collection into a finished ebook — cover, pages and epub. The slow one: several seconds, because the file is built before it answers.
update-book Rename a book, change its credits, or publish it so anyone with the link can download it.
list-book-pages Read a book's pages in order, and which of them survive a layout rebuild.
add-book-page Place a dedication, a section divider or a single recipe into a book.
remove-book-page Take a page out. Nothing else is deleted.
delete-book Delete a book and the pages arranged in it. The recipes and collections it was built from are untouched. It has to send the book's name back as a check.
restore Take a recipe, collection or book back out of the wastebasket. Ask any of the three listing tools for the bin to see what is in there.

A connected app reaches exactly what you reach and nothing more — never another account's recipes, and never anything a shared collection did not already give you. Deleting is permanent and has to name the recipe it is deleting, so an app cannot lose one by mistaking one id for another.

Things to try

Ask in your own words. These are here to show the shape of what works, not a list to be typed exactly.

Finding what you have

“Find all my recipes that use pork and aubergine.”
“What can I make with the chicken thighs and the half jar of harissa?”
“Which of my recipes take under half an hour?”
“Do I already have a brownie recipe, or am I thinking of a different one?”

Adding to it

“Add this recipe: <paste from a message, a photo caption or a book>”
“Save the recipe on this page: https://example.com/dal”
“My gran made this from memory — help me write it down properly, then save it.”

Tidying up

“The stew says two onions but I always use four. Fix it.”
“Add a prep section to the brisket — everything that happens before the oven.”
“My curry recipe has no cooking time on it. Work one out from the method and set it.”

Planning

“Make a collection called Weeknights from my six quickest recipes.”
“Build me a shopping list for the Christmas collection.”
“What is on my Sunday list that I could make ahead on Saturday?”

Worth knowing

Everything stays private: A recipe an AI app writes is private to you, exactly like one you typed in yourself. Nothing is published unless you publish it.
Your wording is kept: Amounts and phrasing are stored as given. If a recipe says "a good glug of oil", it goes on saying that.
It cannot see photographs: Pictures are not reachable over the connection. Recipes, collections, lists and books are.
Nothing is published without you saying so: An app can publish a collection or a book when you ask it to, and it hands back the link. It will not do so on its own, and you can unpublish the same way.
You can disconnect at any time: Under Tokens and connections. Cutting an app off takes effect immediately, and it cannot quietly reconnect itself.