Skip to main content

Digest — local-first nutrition tracking MCP server. Log meals by chatting, see progress in a visual dashboard. USDA + Open Food Facts.

Project description

Digest

Local-first nutrition tracking that runs inside Claude. You log food by chatting. Your data lives in a SQLite file on your machine — no account, no cloud, no signup. A color-coded dashboard shows five numbers at a glance: calories, protein, fiber, carbs, fat. Protein and fiber are targets. Carbs and fat are limits. That's the whole product.

Note: This is a pre-alpha release (0.0.1) reserving the package name while development continues. The core functionality works, but features are still being added. Watch the repo for the 0.1.0 release.

What Digest does

  • Search foods across USDA FoodData Central (380K+) and Open Food Facts (4M+ branded products)
  • Barcode lookup (UPC/EAN)
  • Log meals via natural conversation — calories, protein, carbs, fat, fiber
  • Track goals as targets (protein, fiber) or limits (carbs, fat)
  • Visual dashboard — color-coded progress bars with a calorie ring, updates in place
  • Edit and delete entries with natural language
  • CSV export so your data is never locked in

What Digest doesn't do, by design

  • No meal plans or recipe suggestions
  • No grocery lists
  • No social feed, streaks, or gamification
  • No coaching, nudges, or "helpful" reminders
  • No account, login, or cloud sync
  • No ads, ever

Label photos work. Snap a picture of any nutrition facts panel, paste it into chat, and Claude reads the numbers and logs them. No special tool needed.

Data location

All data lives in ~/.digest/digest.db — a single SQLite file. Delete it and it's gone. Export to CSV anytime. Query it directly with sqlite3 if you want.

Install

pip install digest-mcp

Configure (Claude Desktop)

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "digest": {
      "command": "digest-mcp",
      "env": {
        "USDA_API_KEY": "DEMO_KEY"
      }
    }
  }
}

The DEMO_KEY works for light personal use (~30 requests/hour). For higher limits, get a free key at fdc.nal.usda.gov/api-key-signup.

Restart Claude Desktop, and Digest's tools become available in any chat.

License

MIT. Do whatever you want with it.

Author

Mya — mya@twobitcircus.org

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

digest_mcp-0.0.1.tar.gz (15.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

digest_mcp-0.0.1-py3-none-any.whl (16.1 kB view details)

Uploaded Python 3

File details

Details for the file digest_mcp-0.0.1.tar.gz.

File metadata

  • Download URL: digest_mcp-0.0.1.tar.gz
  • Upload date:
  • Size: 15.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for digest_mcp-0.0.1.tar.gz
Algorithm Hash digest
SHA256 aab1d34d902ef0e3f3904eb8377c3b31c5aa393daa34c9d5b162ede225a4fd4c
MD5 dfad27593963336bc568b1d9bbeea715
BLAKE2b-256 e4d68dc026fdc6e05966fb90e8bd1d44a3433c2ea59917de43ff58afb8feb015

See more details on using hashes here.

File details

Details for the file digest_mcp-0.0.1-py3-none-any.whl.

File metadata

  • Download URL: digest_mcp-0.0.1-py3-none-any.whl
  • Upload date:
  • Size: 16.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for digest_mcp-0.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4933e111a1803ded84ec077619f1f8dce1e258fd004fe38900cfb27256152291
MD5 5756c6a4ebdaf198b0f9823d574dad09
BLAKE2b-256 6c5b4ab8c532961c512efbde047a22a10bd1600c744c7e29c9a72eef3c56ba08

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page