Developers
Build on Tally
Tally exposes a REST API and an MCP server, so you can integrate your own tools and AI assistants with your nutrition and health data.
REST API
JSON endpoints for food, mood, workouts, sleep, and more. Authenticate with a long-lived Bearer token.
MCP Server
Connect AI assistants like Claude directly to your Tally data using the Model Context Protocol.
REST API
A JSON API served at https://www.logwithtally.com/api/v1.
The full OpenAPI 3.1 specification is at
/api.yaml.
Authentication
All endpoints (except the session endpoints) require a Bearer token in the
Authorization header.
Generate your token from Settings → API Access inside Tally.
Authorization: Bearer <your_api_token>
Endpoints
| Method | Path | |
|---|---|---|
| Food | ||
| GET | /api/v1/food_entries | |
| POST | /api/v1/food_entries/parse | |
| POST | /api/v1/food_entries | |
| PATCH | /api/v1/food_entries/:id | |
| DELETE | /api/v1/food_entries/:id | |
| Mood | ||
| GET | /api/v1/mood_entries | |
| POST | /api/v1/mood_entries | |
| DELETE | /api/v1/mood_entries/:id | |
| Workouts & Sleep | ||
| GET | /api/v1/workout_logs | |
| GET | /api/v1/sleep_logs | |
| Feed | ||
| GET | /api/v1/feed | |
All GET endpoints accept a ?date=YYYY-MM-DD parameter (defaults to today in the user's timezone).
See the full OpenAPI spec for request/response schemas.
Quick example
curl https://www.logwithtally.com/api/v1/food_entries?date=2026-06-04 \ -H "Authorization: Bearer <your_api_token>"
MCP Server
Tally implements the Model Context Protocol (MCP 2025-03-26), an open standard that lets AI assistants read and write your data using tool calls. Connect Claude, Cursor, or any MCP-compatible client and let it work with your real food log, workouts, and more.
Connection
| Transport | SSE (Server-Sent Events) |
| SSE URL | https://www.logwithtally.com/mcp/sse |
| Messages URL | https://www.logwithtally.com/mcp/messages |
| Auth | Bearer token — same api_token used by the REST API |
Available tools
| Tool |
|---|
| get_food_log |
| parse_food |
| log_food |
| delete_food_entry |
| log_mood |
| get_workouts |
| get_sleep |
| get_feed |
Example: Connecting from claude.ai
- 1 Go to claude.ai → Settings → Integrations → Add integration.
-
2
Enter the SSE URL:
https://www.logwithtally.com/mcp/sse - 3 Claude will open Tally's authorization page — sign in and click Allow access.
- 4 You'll be redirected back to claude.ai with a live connection. Ask anything about your data.
OAuth 2.0 + PKCE
Tally acts as a full OAuth 2.0 Authorization Server. MCP clients that support dynamic client registration and the MCP 2025-03-26 spec can connect without any manual configuration. PKCE (S256) is required.