JYME MCP Server

What this is

JYME is an AI nutrition tracker. This page documents its Model Context Protocol server, which lets an AI agent work with your own JYME account: log food, water, workouts and weight, and read back macros, statistics and streaks.

POST https://jyme.app/api/mcp

Transport	Streamable HTTP (stateless, JSON-RPC over `POST`)
Auth	`Authorization: Bearer <api_token>`
Tools	18 (10 read-only, 8 write)
Rate limit	60 requests / minute per token
Account	Free JYME account at jyme.app

Note: the server authenticates with a static API token, not OAuth. Use a client that lets you set custom HTTP headers (Claude Code, Cursor, VS Code, your own agent). The one-click custom-connector flow in the Claude web/desktop app requires OAuth and is not supported yet.

Get connected

Create an API token

Sign in at jyme.app and go to Settings → API Tokens for AI Agents → Create Token. Give it a name (e.g. Claude Code) and copy the token immediately — it is shown only once.

Add the server to your client

Claude Code (CLI):

claude mcp add --transport http jyme https://jyme.app/api/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Any client with an mcp.json-style config (Cursor, VS Code, Windsurf, …):

{
  "mcpServers": {
    "jyme": {
      "type": "http",
      "url": "https://jyme.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Check it works

A plain JSON-RPC call should list the available tools:

curl -s https://jyme.app/api/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Then just ask your agent: “What did I eat today and how much protein do I still need?”

Tools

Read — always free

Tool	What it returns
`get_food_entries`	All entries in a date range, with full nutrition data
`get_daily_macros`	Totals for one day plus that day’s limits
`get_weekly_stats`	Daily totals for the last 7 days or a given week
`get_monthly_stats`	Daily totals for a month (`YYYY-MM`) or last 30 days
`get_stats_range`	Daily totals for an arbitrary date range
`search_foods`	Entries matching a name or description
`get_favorites`	Top favorite foods by usage count
`get_user_profile`	Profile, nutrient limits and credit balance
`get_weight_history`	Weight log, newest first
`get_streak`	Current streak, longest streak, today’s status

Write

Tool	What it does	Credits
`add_food_entry`	Creates a food, water or exercise entry with nutrition values	2
`use_favorite`	Logs an entry from an existing favorite	0
`update_food_entry`	Updates an entry (only the fields you pass)	0
`delete_food_entry`	Deletes an entry by ID	0
`add_to_favorites`	Saves a food as a favorite	0
`update_favorite`	Updates a favorite	0
`delete_favorite`	Deletes a favorite and un-stars matching entries	0
`log_weight`	Logs a weight measurement and updates the profile	0

Credits are JYME’s usage currency — new accounts start with 100 and packages can be bought in the app. Only add_food_entry consumes credits over MCP; everything else is free. If the balance is too low the tool returns an explanatory error instead of writing anything.

Behaviour & errors

Every request is scoped to the account that owns the token — an agent can never see another user’s data.
The server is stateless: no session ID is required, each POST is self-contained.
GET and DELETE on the endpoint return 405 — use POST.
Missing or malformed header, or an unknown token → 401.
More than 60 requests per minute per token → 429.
Dates are YYYY-MM-DD; energy is kcal, macros grams, water millilitres.

Data & privacy

A token grants full read and write access to that account’s nutrition data — treat it like a password, store it in your client’s secret store, and delete it in Settings → API Tokens when you no longer need it. Tokens are stored only as a SHA-256 hash and each one records its last use, so unexpected activity is visible.

Data handling follows JYME’s terms and privacy policy, available in the app under Account → About. Questions: ludvik.wiejowski@gmail.com.

JYME