Amy Amy

Amy API Docs

Reference for Amy's REST API and OAuth-authenticated connector access. For MCP setup, use Amy Settings > Connect Amy in the app.

Connect Amy

MCP server URL https://connect.amyfoodjournal.com/mcp
REST API base URL https://connect.amyfoodjournal.com/api/v1

Hosted AI clients should use OAuth through the MCP URL. API keys are available in the Amy app for scripts and clients that support custom bearer-token headers.

API Reference

Interactive OpenAPI reference powered by Scalar.

Authentication

REST with an API key

curl -H "Authorization: Bearer YOUR_AMY_API_KEY" \
  "https://connect.amyfoodjournal.com/api/v1/nutrition/summary?date=2026-06-14"

MCP JSON

{
  "mcpServers": {
    "amy": {
      "type": "http",
      "url": "https://connect.amyfoodjournal.com/mcp"
    }
  }
}

Claude Code

claude mcp add --transport http amy https://connect.amyfoodjournal.com/mcp \
  --header "Authorization: Bearer YOUR_AMY_API_KEY"

Rate Limits

API requests 120 per key per hour
OAuth connector requests 240 per user/client per hour
MCP nutrition mutations 12 per 10 minutes, 25 per hour, 60 per day
MCP food logging 12 visible food lines per request
Created food lines 30 per 10 minutes, 60 per hour, 100 per day
Active API keys 10 per user