Connector setup
Connect Macroline to Claude
Macroline runs as an MCP server. Once it's connected to Claude, you can log meals, search foods, and read your macro summary directly from chat — no app switching.
What you can do
- Log meals from chat. "I had a chicken caesar wrap and a coke for lunch — log it." Claude finds the foods, calculates macros, writes the diary entry.
- Ask about your trends. "What was my average protein last week?" or "Which day this month did I eat over my carb goal?"
- Search the food database. Get verified macros for any food, brand, or chain restaurant item — with the source cited.
- Adjust your goals. Tell Claude to bump your protein target up to 180g; it updates Macroline directly.
Setup, in three steps
- 1
Open Claude and go to Connectors
On claude.ai or the Claude desktop app: Settings → Connectors → Add custom connector.
If "Add custom connector" isn't visible, your account may need to be opted in. See Anthropic's connector docs.
- 2
Paste the Macroline server URL
Use this URL when Claude asks for the MCP server address:
https://api.macroline.app/mcp
Claude reads our metadata, discovers the available tools, and asks you to authorize. You'll be redirected to Macroline's sign-in page.
- 3
Sign in and approve
Sign in with your Macroline email and password. You'll see exactly what Claude is allowed to do (search foods, read diary, log meals, set goals). Approve, and you're connected.
Don't have a Macroline account yet? Get the app first — signup takes about a minute.
What's exposed to Claude
Nine tools, scoped to your account. Each one is annotated as read-only or write — no surprise mutations.
| Tool | What it does | Type |
|---|---|---|
search_food | Find foods by name or brand. Returns verified macros + source. | Read |
get_diary | Read your diary entries within a date range. | Read |
get_summary | Daily macro totals and your goals for any date. | Read |
list_exercises | Browse the supported exercise catalog with MET values. Filter by name or category. | Read |
get_exercise_logs | Read your exercise sessions in a date range, with the calories-burned estimate from log time. | Read |
log_meal | Add foods to your diary. Idempotent — safe to retry. | Write |
log_exercise | Record an exercise session. Calories estimated from MET × weight × duration. | Write |
log_water | Log a hydration entry by volume (mL). Idempotent. | Write |
set_goals | Update your daily calorie and macro goals. | Write |
Privacy + security
- OAuth 2.1 with PKCE. Token-based auth. No passwords stored on Claude's side. Revoke any time from your Macroline account.
- Scoped access. Claude can only do what the four scopes above allow. Adding new capabilities requires re-authorizing.
- No model training on your data. Your diary, goals, and search history are not used by us or Anthropic to train AI models.
- Snapshot integrity. Diary entries logged via Claude are snapshotted with the macros at log time. Future corrections to a food row don't change your past totals.
Full details: privacy policy.
Troubleshooting
Claude says it can't find the connector
Make sure you pasted the URL exactly: https://api.macroline.app/mcp. No trailing slash, no extra protocol prefix. If that's right, try removing and re-adding the connector.
The sign-in page rejects my password
Use the same email and password you use for the Macroline iOS app. If you signed up via Apple or Google SSO and never set a password, open the iOS app, sign out, and choose "Sign up with email" to create one — then come back to the connector flow.
I get an "access_denied" error
That means you clicked Cancel on the consent screen. Re-trigger the connector flow from Claude and choose Approve.
Claude logs an entry twice
This shouldn't happen — the log_meal tool is idempotent and Claude is supposed to retry with the same request id. If you see a duplicate, please let us know with the entry IDs and timestamp.
How do I disconnect Claude?
From Claude: Settings → Connectors → Macroline → Remove. From Macroline: open the iOS app, Settings → Connect AI → Revoke all sessions.
Ready?
Open Claude, add a custom connector, and paste the URL.
https://api.macroline.app/mcp
Don't have Macroline yet? Get the app first — connecting Claude after takes about 90 seconds.