DataBody databody v2.0
Search docs ⌘K
Docs Download · iOS
00AGENT TOOLS

The full tool registry.

DataBody's AI doesn't just chat. It executes real actions through these tools to autonomously manage your nutrition, check-ins, workouts, recipes, and household meal planning. Every tool is callable from the iOS app, CLI, MCP, or any API client.
lib/agent/tools
40 exports
40 tools 8 categories Streaming responses OAuth 2.0 + PKCE Works in Claude · ChatGPT · CLI
01

Health & Data

8 tools
health_summary #

Get dashboard including today's macros vs targets, body stats, weight trends, and recent workouts.

Example prompt "How am I doing today?" or "What's my progress this week?"
current_goal #

Get active fitness goal including daily calorie/macro targets, fiber, sugar, water, caffeine, and alcohol (UK units) limits, and strategy (cut/maintain/bulk).

Example prompt "What are my macro targets?" or "Remind me of my goal"
todays_nutrition #

Get all food logs for today with detailed macro breakdowns per meal.

Example prompt "What have I eaten today?" or "Show me today's meals"
nutrition_history #

Get nutrition logs for previous days. Up to 30 days of history.

Example prompt "What did I eat yesterday?" or "Show me last week's nutrition"
recent_workouts #

Get recent workouts including type, duration, calories, and heart rate data.

Example prompt "Show me my recent workouts" or "When did I last do cardio?"
log_weight #

Manually log a weight measurement. Optionally include body fat percentage. Shows change from previous measurement.

Example prompt "I weighed 175 lbs this morning" or "Log my weight: 80 kg, 18% body fat"
set_goal #

Create or update your fitness goal. Just provide target body fat % and weekly loss rate — calories, protein, carbs, fat, and timeline are auto-calculated. Optionally set daily fiber, sugar, caffeine (mg), and alcohol (UK units) limits, and enable water tracking with body-weight-based targets that adjust for workout activity. Includes projections for different approaches so the AI can guide you through trade-offs.

Example prompt "Set my goal to 15% body fat" or "I want to be more aggressive with my cut"
calculate_goal_projection #

Explore "what if" scenarios without changing your goal. Ask about different targets or timelines and see projections for conservative, moderate, and aggressive approaches — including daily calories, weekly weight loss, and estimated completion dates.

Example prompt "How long to reach 12% body fat?" or "What could I achieve by June if I went aggressive?"
02

Food Logging

8 tools
log_food #

Log food items with full macro data including fiber, sugar, water, caffeine, and alcohol (UK units computed from volume × ABV). AI automatically estimates water content for all foods and drinks, caffeine for coffee/tea/energy drinks, and alcohol units for beer/wine/spirits. Supports multiple items per meal, optional captions, and auto-attaches photos when logging via image.

Example prompt "I had 2 eggs and toast for breakfast" or [Send photo] "Log this meal and share it publicly"
copy_meal #

Copy a meal from a previous day to today. Perfect for recurring meals you eat regularly.

Example prompt "Log the same breakfast I had yesterday" or "Copy Monday's dinner"
update_food_item #

Edit a food item in any day's log — today or past days. Correct macros (including fiber, sugar, water, caffeine, and alcohol units), rename items, or adjust serving sizes without deleting and re-logging.

Example prompt "Change yesterday's chicken to 250 calories" or "The rice I logged should be 200g not 150g"
delete_food_item #

Remove a food item from any day's log — today or past days. Use when something was logged by mistake or not actually eaten.

Example prompt "Remove the toast I logged" or "I didn't actually eat that banana yesterday"
search_food_database #

Search food databases (FatSecret, USDA, OpenFoodFacts) for accurate nutrition data.

Example prompt "How many calories in a Chipotle burrito bowl?" or "Look up Greek yogurt macros"
favorite_foods #

Get saved favorite foods for quick logging.

Example prompt "Show my favorite foods" or "What do I usually eat?"
search_food_history #

Search past foods by name to find exact macros from previous logs.

Example prompt "Log the same muesli I had yesterday" or "What was in that smoothie I made?"
get_recent_intake New #

Get the sum of food, water, and alcohol consumed over the last N minutes. Useful for hangover prevention ("did I eat before drinking?"), workout fueling decisions, late-night snacking awareness, and meal-timing questions.

Example prompt "Have I eaten enough before my run?" or "I'm about to have wine — how much food have I had today?"
03

Check-ins

4 tools · new
record_checkin New #

Record how you feel at any moment on a 1–10 scale: mood, energy, sleep quality, hydration feeling, gut feeling, skin health, and hangover severity. All fields are optional and you can check in multiple times per day. The coach listens for signals in natural conversation ("I'm exhausted" → energy=1, "broke out again" → skin=3) and records them automatically.

Example prompt "I slept great last night, probably a 9" or "My mood is about a 6 and I feel bloated after lunch"
get_checkins New #

List your recent check-ins. Use this to answer questions about how you've been feeling, spot trends, or find correlations between sleep, food, workouts, and how you felt.

Example prompt "How was my week?" or "When's the last time I had a bad hangover?"
update_checkin New #

Edit an existing check-in. Perfect for correcting a rating after reflection ("actually my mood was more like a 7").

Example prompt "Actually, my energy was better than I said — bump it to 7"
delete_checkin New #

Remove a check-in by id. Use when one was recorded by mistake.

Example prompt "Delete that last check-in, I wasn't feeling that good"
04

Saved Meals

5 tools · new
create_saved_meal New #

Save a named meal template with individual ingredients and macros (including fiber, sugar, water, caffeine, and alcohol). Perfect for breakfasts, lunches, or snacks you eat regularly. Can also save from a previously logged meal.

Example prompt "Create a meal called cold cereal: 3/4C muesli, 1/4C granola, 1/2C hemp milk, 1 scoop whey protein" or "Save that as my morning shake"
log_saved_meal New #

Log a saved meal by name with all its ingredients in one step. Supports adding extras or skipping items for easy variations.

Example prompt "Log cold cereal" or "Log cold cereal plus half a banana" or "Log my morning shake without the peanut butter"
update_saved_meal New #

Modify a saved meal template — rename it, add new ingredients, remove items, or replace the entire recipe.

Example prompt "Add blueberries to my cold cereal meal" or "Remove trail mix from cold cereal" or "Rename cold cereal to morning cereal"
get_saved_meals New #

View all your saved meal templates with their ingredients and total macros.

Example prompt "What saved meals do I have?" or "Show me my meal templates"
delete_saved_meal New #

Remove a saved meal template you no longer need.

Example prompt "Delete my cold cereal meal" or "Remove morning shake from saved meals"
05

Workout Logging

3 tools
log_workout #

Log a workout with type, duration, and calories. Auto-estimates calories using MET values if not provided.

Example prompt "I ran for 30 minutes this morning" or "Log a 45 min strength session"
update_workout #

Update a manually-logged workout's details (type, duration, calories, etc).

Example prompt "Actually that run was 45 minutes, not 30" or "Change my workout to HIIT"
delete_workout #

Delete a manually-logged workout. HealthKit workouts can't be deleted.

Example prompt "Delete the workout I just logged" or "Remove today's run"
06

Memory & Notes

3 tools
personal_notes #

Get personal notes containing preferences, dietary restrictions, and other remembered info.

Example prompt "What do you know about my preferences?" or "What are my restrictions?"
save_note #

Save a note to remember preferences, restrictions, or other important info for future conversations.

Example prompt "Remember that I'm lactose intolerant" or "Note: I don't eat red meat"
search_chat_history #

Search past conversations using full-text search with date and role filters.

Example prompt "What did we talk about regarding protein?" or "Find where I mentioned the salmon recipe"
07

Households

3 tools
view_households #

Get all households the user belongs to with member lists.

Example prompt "Who's in my household?" or "Show my family members"
household_summary #

Get health data for all household members including goals, stats, notes, and recent nutrition.

Example prompt "What are everyone's macro targets?" or "Plan dinner for the family"
suggest_meal_to_member #

Create a pending food log for another household member. They can accept or decline.

Example prompt "Log dinner for my wife too" or "Share this meal with Alex"
08

Grocery Lists

6 tools
create_grocery_list #

Create a new grocery list with optional store name and budget. AI can create lists based on your meal plans and macro goals.

Example prompt "Create a grocery list for Trader Joe's with a $100 budget" or "Start a new shopping list"
add_grocery_items #

Add items to your grocery list with automatic categorization. Items are organized by aisle (produce, dairy, meat, etc.) for efficient shopping.

Example prompt "Add chicken, broccoli, and eggs to my grocery list" or "I need milk, bread, and bananas"
check_grocery_items #

Mark items as picked up. Send a photo of your groceries and AI will identify and check off matching items automatically.

Example prompt [Send photo of groceries] "I just picked these up" or "Check off the chicken and broccoli"
set_item_prices #

Track spending by setting prices on items. Send a photo of your receipt and AI will extract and match prices to your items.

Example prompt [Send receipt photo] "Here's my receipt" or "The chicken was $8.99"
fridge_inventory #

See what's likely in your fridge based on recent purchases. AI estimates freshness based on category (produce vs pantry items).

Example prompt "What do I have in my fridge?" or "What ingredients do I have at home?"
suggest_grocery_items #

Get smart suggestions based on your macro goals, eating patterns, and remaining budget. AI recommends items that fit your nutrition plan.

Example prompt "What should I add to my list?" or "Suggest high-protein items within my budget"
09

Planning & Recipes

5 tools
search_recipes #

Search for recipes from trusted cooking sites with title, URL, image, and estimated macros.

Example prompt "Find high protein dinner recipes" or "Show me low carb chicken ideas"
schedule_meal #

Add a meal to your calendar with nutrition info, reminders, and recipe links.

Example prompt "Schedule this for dinner on Friday" or "Add meal prep Sunday to my calendar"
create_recipe #

Save your own recipes with macros, servings, and instructions. Link recipes to meals for quick logging.

Example prompt "Save this as a recipe" or "Create a recipe for my protein pancakes"
get_recipes #

View your saved recipes with macro information and serving sizes.

Example prompt "Show my recipes" or "What recipes do I have saved?"
10

Meal Visibility & Sharing

3 tools
set_meal_visibility #

Control whether your meals appear in your friends' feed. Set meals to public or private.

Example prompt "Share my lunch publicly" or "Make my last meal private"
associate_photo #

Attach photos to logged meals. Photos auto-attach when you log via image, or add them later. Photos show up in the Friend Feed when meals are shared publicly.

Example prompt [Send photo] "Add this photo to my lunch" or "Attach the image to my last meal"
add_meal_caption #

Add captions to your meals like Instagram. Captions display with your username in bold in the Friend Feed. Include captions when logging or add them later.

Example prompt "Log this with caption: meal prep Sunday!" or "Add a caption to my last meal"
REAL TOOLS · REAL ACTIONS

Stop chatting. Start executing.

This isn't AI chat with logging. DataBody's agent autonomously runs these tools to manage your nutrition.