Skip to content

mcp.json with a key

Use Forkmate in Cursor

Cursor’s desktop app connects to Forkmate with a personal key. Make one, add the mcp.json below, and Cursor’s agent can log your meals.

Needs a key. Cursor runs on your computer, so it connects with a personal key instead of a sign-in. Make a key in Forkmate · How keys work

No Forkmate account yet? Create one free first. It takes under a minute. You make your key there.

Example: in Cursor, with Forkmate connected

I had two eggs and toast for breakfast.

Logged to Forkmate229 kcal
Egg, whole, cooked, hard-boiled · 2 large eggs (100 g)Bread, white · 1 slice (28 g)

Logged. Want me to total today so far?

Set up Forkmate in Cursor

Forkmate’s server URL
https://mcp.forkmate.ai/
Streamable HTTP, with your personal key in the Authorization header.
  1. Make a keyIn Forkmate, open Settings → Keys for local apps (https://app.forkmate.ai/#keys), name the key after Cursor, pick when it expires and click Make key. Copy it: Forkmate shows it once. How keys work: forkmate.ai/connect/keys/.
  2. Add the serverPut the JSON below in ~/.cursor/mcp.json with your key in place of fmk_your_key_here, then check Forkmate is on under Customize in the sidebar.
  3. Give your OK onceThe first time you log, Forkmate asks once for your OK to store your food diary. Agree the way it asks, in the chat or through the link it gives you to agree on the web, then log the meal again if it wasn’t saved.
  4. Log your first mealIn Cursor’s agent, say “I had two eggs and toast for breakfast.” It logs the meal with calories and macros to your Forkmate diary.

~/.cursor/mcp.json

{
  "mcpServers": {
    "forkmate": {
      "url": "https://mcp.forkmate.ai/",
      "headers": {
        "Authorization": "Bearer fmk_your_key_here"
      }
    }
  }
}

Or keep the key out of the file

{
  "mcpServers": {
    "forkmate": {
      "url": "https://mcp.forkmate.ai/",
      "headers": {
        "Authorization": "Bearer ${env:FORKMATE_KEY}"
      }
    }
  }
}

Cursor fills in ${env:FORKMATE_KEY} from your environment.

What you need

  • A free Forkmate account (sign up). There is no paid plan.
  • Any Cursor plan.

Checked against the vendor’s documentation: Cursor docs: MCP. Cursor changes its menus often; if yours looks different, trust what it shows.

What to say first

Talk to Cursor the way you’d tell a friend:

  • “I had two eggs and toast for breakfast.”
  • “How many calories have I had today?”
  • “Make the toast two slices.”
  • “What did I eat this week?”

It logs the meal with calories, protein, carbs and fat to your diary at app.forkmate.ai.

Good to know in Cursor

  • Turn Forkmate on or off from Customize in the sidebar. A server that’s off doesn’t load or appear in chat.
  • Cursor asks before running MCP tools by default.
  • Cursor’s CLI reads the same mcp.json, so it uses the same key.

If something goes wrong in Cursor

A Forkmate call fails in chat
Open the Output panel (Cmd/Ctrl+Shift+U) and pick MCP Logs to see the error.

Checked against Cursor docs: MCP, Cursor docs: MCP in the CLI.

Forkmate shortcuts

Forkmate comes with ready-made requests for the everyday jobs: log a meal, fix the last entry, see what’s left today, log your usual, hit your protein, a weekly check-in. Cursor supports MCP shortcuts (prompts). In the agent chat, type / to look for Forkmate’s; if your version doesn’t list them, type the request instead.

  • Log a meal (log-meal)
    “Log this to my Forkmate diary: two eggs and toast with butter”
  • Fix my last entry (fix-last-entry)
    “Fix the last thing I logged in Forkmate: it was 2 eggs, not 3”
  • What's left today (today-so-far)
    “Show me today so far in Forkmate: my calories, protein, carbs and fat.”
  • Log my usual (log-my-usual)
    “Log my usual breakfast to Forkmate.”
  • Hit my protein today (hit-protein)
    “How much protein have I had today in Forkmate, and how far am I from my target of 120 g? Suggest a few foods for my remaining meals and snacks that would close the gap, using my food profile and the foods I usually eat.”
  • Weekly check-in (week-review)
    “Give me a check-in on my last 7 days in Forkmate (get_range): calories, protein, carbs and fat per day and on average, how many days I logged, and the foods I ate most.”
  • Move my MyFitnessPal history (import-myfitnesspal)
    “How do I move my food diary history from MyFitnessPal to Forkmate? Walk me through exporting my data for free and importing it with the guided importer described at https://forkmate.ai/migrate-from-myfitnesspal/. Don't log anything yet.”

Shortcut or not, Forkmate sends Cursor the same logging rules when it connects: log your own words, keep your amounts, and look foods up before estimating.

Fueling for a run or ride

Forkmate doesn’t sync with Strava or Garmin. Describe the session and Cursor reads your food from Forkmate:

  • Help me fuel for a PR on my local route. It usually takes me about 50 minutes, with a few short climbs. Read my Forkmate diary for the last week, then give me a before, during and after plan. Ask me what you need first.
  • How have I been eating, and how should I fuel for a 10K? Read the last 14 days of my Forkmate diary. I run about four times a week and my 10K is in three weeks. Ask me anything else you need.
  • What should I eat before, during and after my long ride? It's about 3 hours at a moderate pace. Read what I've eaten the last three days in Forkmate, and ask me what you need first.

More, including Garmin through Apple Health and a free Claude Skill: Use Forkmate with Strava or Garmin.

Start logging from Cursor

Create your free account, connect once, and your next meal is one sentence away. No card, no paid plan.

All assistantsStart free