cronometer-api-mcp 0.1.0__tar.gz

cronometer_api_mcp-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,24 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Lint with ruff
+        run: uv run ruff check
+
+      - name: Check formatting with ruff
+        run: uv run ruff format --check

cronometer_api_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,25 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      # Required for PyPI trusted publishing via OIDC
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

cronometer_api_mcp-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+.env
+__pycache__/
+*.pyc
+.venv/
+*.egg-info/
+dist/
+build/
+.ruff_cache/

cronometer_api_mcp-0.1.0/.python-version

@@ -0,0 +1 @@
+3.14

cronometer_api_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Randy Westergren
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cronometer_api_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,225 @@
+Metadata-Version: 2.4
+Name: cronometer-api-mcp
+Version: 0.1.0
+Summary: MCP server for Cronometer nutrition data using the mobile REST API
+Author: Randy
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cronometer,health,mcp,model-context-protocol,nutrition
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
+Requires-Python: >=3.14
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: uvicorn>=0.30.0
+Description-Content-Type: text/markdown
+
+# cronometer-api-mcp
+
+<!-- mcp-name: io.github.rwestergren/cronometer-api-mcp -->
+
+An [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server for [Cronometer](https://cronometer.com/) nutrition tracking, built on the reverse-engineered mobile REST API.
+
+Unlike [cronometer-mcp](https://github.com/cphoskins/cronometer-mcp) which uses the fragile GWT-RPC web protocol (with magic hashes that break on every Cronometer deploy), this server uses the same JSON API that the Cronometer Android app uses -- clean payloads, stable endpoints, no permutation hashes.
+
+## Features
+
+- **Food log** -- diary entries with food names, amounts, meal groups
+- **Nutrition data** -- daily macro/micro totals and nutrition scores with per-nutrient confidence
+- **Food search** -- search the Cronometer food database, get detailed nutrition info
+- **Diary management** -- add/remove entries, copy days, mark days complete
+- **Custom foods** -- create foods with custom nutrition data
+- **Macro targets** -- read weekly schedule and saved templates
+- **Fasting** -- view history and aggregate statistics
+
+## Quick Start
+
+### 1. Install [uv](https://docs.astral.sh/uv/)
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+### 2. Set credentials
+
+```bash
+export CRONOMETER_USERNAME="your@email.com"
+export CRONOMETER_PASSWORD="your-password"
+```
+
+### 3. Configure your MCP client
+
+`uvx` downloads and runs the server on demand -- no separate install step.
+
+#### OpenCode (`opencode.json`)
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "cronometer": {
+      "type": "local",
+      "command": ["uvx", "cronometer-api-mcp"],
+      "environment": {
+        "CRONOMETER_USERNAME": "{env:CRONOMETER_USERNAME}",
+        "CRONOMETER_PASSWORD": "{env:CRONOMETER_PASSWORD}"
+      },
+      "enabled": true
+    }
+  }
+}
+```
+
+#### Claude Desktop (`claude_desktop_config.json`)
+
+```json
+{
+  "mcpServers": {
+    "cronometer": {
+      "command": "uvx",
+      "args": ["cronometer-api-mcp"],
+      "env": {
+        "CRONOMETER_USERNAME": "your@email.com",
+        "CRONOMETER_PASSWORD": "your-password"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+### Food Log & Nutrition
+
+| Tool | Description |
+|------|-------------|
+| `get_food_log` | Diary entries for a date with food names, amounts, and meal groups |
+| `get_daily_nutrition` | Daily macro and micronutrient totals |
+| `get_nutrition_scores` | Category scores (Vitamins, Minerals, etc.) with per-nutrient consumed amounts and confidence levels |
+
+### Food Search & Details
+
+| Tool | Description |
+|------|-------------|
+| `search_foods` | Search the Cronometer food database by name |
+| `get_food_details` | Full nutrition profile and serving sizes for a food |
+
+### Diary Management
+
+| Tool | Description |
+|------|-------------|
+| `add_food_entry` | Log a food serving to the diary |
+| `remove_food_entry` | Remove one or more diary entries |
+| `add_custom_food` | Create a custom food with specified nutrition |
+| `copy_day` | Copy all entries from the previous day |
+| `mark_day_complete` | Mark a diary day as complete or incomplete |
+
+### Targets & Tracking
+
+| Tool | Description |
+|------|-------------|
+| `get_macro_targets` | Weekly macro schedule and saved target templates |
+| `get_fasting_history` | Fasting history within a date range |
+| `get_fasting_stats` | Aggregate fasting statistics |
+
+All date parameters use `YYYY-MM-DD` format and default to today when omitted.
+
+## Remote Deployment
+
+The server supports remote deployment with OAuth 2.1 authorization (PKCE) for use with Claude.ai and other remote MCP clients.
+
+### Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `CRONOMETER_USERNAME` | Yes | Cronometer account email |
+| `CRONOMETER_PASSWORD` | Yes | Cronometer account password |
+| `MCP_TRANSPORT` | No | Transport mode: `stdio` (default), `sse`, or `streamable-http` |
+| `MCP_AUTH_TOKEN` | No | Bearer token for remote auth (enables OAuth flow) |
+| `MCP_OAUTH_CLIENT_ID` | No | OAuth client ID for remote clients |
+| `MCP_OAUTH_CLIENT_SECRET` | No | OAuth client secret for remote clients |
+| `MCP_BASE_URL` | No | Public base URL for OAuth metadata endpoints |
+| `PORT` | No | Listen port for remote transports (default 8000) |
+
+### Dokku / Heroku Deployment
+
+The project includes a `Procfile` and `.python-version` for direct deployment with the Heroku Python buildpack:
+
+```bash
+# Create app
+dokku apps:create cronometer-api-mcp
+
+# Set environment
+dokku config:set cronometer-api-mcp \
+  MCP_TRANSPORT=streamable-http \
+  MCP_AUTH_TOKEN=$(openssl rand -hex 32) \
+  MCP_OAUTH_CLIENT_ID=my-client \
+  MCP_OAUTH_CLIENT_SECRET=$(openssl rand -hex 32) \
+  MCP_BASE_URL=https://your-domain.com \
+  CRONOMETER_USERNAME=your@email.com \
+  CRONOMETER_PASSWORD=your-password
+
+# Deploy
+git push dokku main
+```
+
+### Claude.ai Remote Connection
+
+When deployed remotely with OAuth configured, connect from Claude.ai using:
+
+- **Server URL**: `https://your-domain.com/mcp`
+- **OAuth Client ID**: Value of `MCP_OAUTH_CLIENT_ID`
+- **OAuth Client Secret**: Value of `MCP_OAUTH_CLIENT_SECRET`
+
+Claude.ai will open a browser tab for authorization. Click **Authorize** to complete the connection.
+
+## How It Works
+
+This server communicates with `mobile.cronometer.com` -- the same REST API used by the Cronometer Android/Flutter app. The API was reverse-engineered through:
+
+1. Static analysis of `libapp.so` (Dart AOT snapshot) from the APK to discover endpoint names
+2. Traffic interception via Frida + mitmproxy to capture exact request/response formats
+3. Trial-and-error against the live API to confirm payload shapes
+
+The API uses two protocols:
+
+- **v2 (`POST /api/v2/*`)** -- JSON-body auth, used for most operations (food search, diary read/write, nutrition, fasting, macros)
+- **v3 (`DELETE /api/v3/user/{id}/*`)** -- Header-based auth (`x-crono-session`), used for diary entry deletion
+
+## Python API
+
+You can use the client directly:
+
+```python
+from cronometer_api_mcp.client import CronometerClient
+from datetime import date
+
+client = CronometerClient()
+
+# Search for foods
+results = client.search_food("chicken breast")
+
+# Get food details
+food = client.get_food(results[0]["id"])
+
+# Log a serving
+client.add_serving(
+    food_id=food["id"],
+    measure_id=food["defaultMeasureId"],
+    grams=200,
+)
+
+# Get today's diary
+diary = client.get_diary()
+
+# Get nutrition scores
+scores = client.get_nutrition_scores()
+```
+
+## License
+
+MIT

cronometer_api_mcp-0.1.0/Procfile

@@ -0,0 +1 @@
+web: cronometer-api-mcp

cronometer_api_mcp-0.1.0/README.md

@@ -0,0 +1,205 @@
+# cronometer-api-mcp
+
+<!-- mcp-name: io.github.rwestergren/cronometer-api-mcp -->
+
+An [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server for [Cronometer](https://cronometer.com/) nutrition tracking, built on the reverse-engineered mobile REST API.
+
+Unlike [cronometer-mcp](https://github.com/cphoskins/cronometer-mcp) which uses the fragile GWT-RPC web protocol (with magic hashes that break on every Cronometer deploy), this server uses the same JSON API that the Cronometer Android app uses -- clean payloads, stable endpoints, no permutation hashes.
+
+## Features
+
+- **Food log** -- diary entries with food names, amounts, meal groups
+- **Nutrition data** -- daily macro/micro totals and nutrition scores with per-nutrient confidence
+- **Food search** -- search the Cronometer food database, get detailed nutrition info
+- **Diary management** -- add/remove entries, copy days, mark days complete
+- **Custom foods** -- create foods with custom nutrition data
+- **Macro targets** -- read weekly schedule and saved templates
+- **Fasting** -- view history and aggregate statistics
+
+## Quick Start
+
+### 1. Install [uv](https://docs.astral.sh/uv/)
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+### 2. Set credentials
+
+```bash
+export CRONOMETER_USERNAME="your@email.com"
+export CRONOMETER_PASSWORD="your-password"
+```
+
+### 3. Configure your MCP client
+
+`uvx` downloads and runs the server on demand -- no separate install step.
+
+#### OpenCode (`opencode.json`)
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "cronometer": {
+      "type": "local",
+      "command": ["uvx", "cronometer-api-mcp"],
+      "environment": {
+        "CRONOMETER_USERNAME": "{env:CRONOMETER_USERNAME}",
+        "CRONOMETER_PASSWORD": "{env:CRONOMETER_PASSWORD}"
+      },
+      "enabled": true
+    }
+  }
+}
+```
+
+#### Claude Desktop (`claude_desktop_config.json`)
+
+```json
+{
+  "mcpServers": {
+    "cronometer": {
+      "command": "uvx",
+      "args": ["cronometer-api-mcp"],
+      "env": {
+        "CRONOMETER_USERNAME": "your@email.com",
+        "CRONOMETER_PASSWORD": "your-password"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+### Food Log & Nutrition
+
+| Tool | Description |
+|------|-------------|
+| `get_food_log` | Diary entries for a date with food names, amounts, and meal groups |
+| `get_daily_nutrition` | Daily macro and micronutrient totals |
+| `get_nutrition_scores` | Category scores (Vitamins, Minerals, etc.) with per-nutrient consumed amounts and confidence levels |
+
+### Food Search & Details
+
+| Tool | Description |
+|------|-------------|
+| `search_foods` | Search the Cronometer food database by name |
+| `get_food_details` | Full nutrition profile and serving sizes for a food |
+
+### Diary Management
+
+| Tool | Description |
+|------|-------------|
+| `add_food_entry` | Log a food serving to the diary |
+| `remove_food_entry` | Remove one or more diary entries |
+| `add_custom_food` | Create a custom food with specified nutrition |
+| `copy_day` | Copy all entries from the previous day |
+| `mark_day_complete` | Mark a diary day as complete or incomplete |
+
+### Targets & Tracking
+
+| Tool | Description |
+|------|-------------|
+| `get_macro_targets` | Weekly macro schedule and saved target templates |
+| `get_fasting_history` | Fasting history within a date range |
+| `get_fasting_stats` | Aggregate fasting statistics |
+
+All date parameters use `YYYY-MM-DD` format and default to today when omitted.
+
+## Remote Deployment
+
+The server supports remote deployment with OAuth 2.1 authorization (PKCE) for use with Claude.ai and other remote MCP clients.
+
+### Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `CRONOMETER_USERNAME` | Yes | Cronometer account email |
+| `CRONOMETER_PASSWORD` | Yes | Cronometer account password |
+| `MCP_TRANSPORT` | No | Transport mode: `stdio` (default), `sse`, or `streamable-http` |
+| `MCP_AUTH_TOKEN` | No | Bearer token for remote auth (enables OAuth flow) |
+| `MCP_OAUTH_CLIENT_ID` | No | OAuth client ID for remote clients |
+| `MCP_OAUTH_CLIENT_SECRET` | No | OAuth client secret for remote clients |
+| `MCP_BASE_URL` | No | Public base URL for OAuth metadata endpoints |
+| `PORT` | No | Listen port for remote transports (default 8000) |
+
+### Dokku / Heroku Deployment
+
+The project includes a `Procfile` and `.python-version` for direct deployment with the Heroku Python buildpack:
+
+```bash
+# Create app
+dokku apps:create cronometer-api-mcp
+
+# Set environment
+dokku config:set cronometer-api-mcp \
+  MCP_TRANSPORT=streamable-http \
+  MCP_AUTH_TOKEN=$(openssl rand -hex 32) \
+  MCP_OAUTH_CLIENT_ID=my-client \
+  MCP_OAUTH_CLIENT_SECRET=$(openssl rand -hex 32) \
+  MCP_BASE_URL=https://your-domain.com \
+  CRONOMETER_USERNAME=your@email.com \
+  CRONOMETER_PASSWORD=your-password
+
+# Deploy
+git push dokku main
+```
+
+### Claude.ai Remote Connection
+
+When deployed remotely with OAuth configured, connect from Claude.ai using:
+
+- **Server URL**: `https://your-domain.com/mcp`
+- **OAuth Client ID**: Value of `MCP_OAUTH_CLIENT_ID`
+- **OAuth Client Secret**: Value of `MCP_OAUTH_CLIENT_SECRET`
+
+Claude.ai will open a browser tab for authorization. Click **Authorize** to complete the connection.
+
+## How It Works
+
+This server communicates with `mobile.cronometer.com` -- the same REST API used by the Cronometer Android/Flutter app. The API was reverse-engineered through:
+
+1. Static analysis of `libapp.so` (Dart AOT snapshot) from the APK to discover endpoint names
+2. Traffic interception via Frida + mitmproxy to capture exact request/response formats
+3. Trial-and-error against the live API to confirm payload shapes
+
+The API uses two protocols:
+
+- **v2 (`POST /api/v2/*`)** -- JSON-body auth, used for most operations (food search, diary read/write, nutrition, fasting, macros)
+- **v3 (`DELETE /api/v3/user/{id}/*`)** -- Header-based auth (`x-crono-session`), used for diary entry deletion
+
+## Python API
+
+You can use the client directly:
+
+```python
+from cronometer_api_mcp.client import CronometerClient
+from datetime import date
+
+client = CronometerClient()
+
+# Search for foods
+results = client.search_food("chicken breast")
+
+# Get food details
+food = client.get_food(results[0]["id"])
+
+# Log a serving
+client.add_serving(
+    food_id=food["id"],
+    measure_id=food["defaultMeasureId"],
+    grams=200,
+)
+
+# Get today's diary
+diary = client.get_diary()
+
+# Get nutrition scores
+scores = client.get_nutrition_scores()
+```
+
+## License
+
+MIT

cronometer_api_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "cronometer-api-mcp"
+version = "0.1.0"
+description = "MCP server for Cronometer nutrition data using the mobile REST API"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.14"
+authors = [
+    { name = "Randy" },
+]
+keywords = ["cronometer", "mcp", "nutrition", "health", "model-context-protocol"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Scientific/Engineering :: Medical Science Apps.",
+]
+dependencies = [
+    "mcp>=1.0.0",
+    "httpx>=0.27.0",
+    "uvicorn>=0.30.0",
+]
+
+[project.scripts]
+cronometer-api-mcp = "cronometer_api_mcp.server:main"
+
+[dependency-groups]
+dev = [
+    "ruff>=0.8.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/cronometer_api_mcp"]

cronometer_api_mcp-0.1.0/server.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.rwestergren/cronometer-api-mcp",
+  "description": "MCP server for Cronometer nutrition tracking via the mobile REST API — food logs, nutrition scores, diary management, macros, fasting",
+  "repository": {
+    "url": "https://github.com/rwestergren/cronometer-api-mcp",
+    "source": "github"
+  },
+  "version": "0.1.0",
+  "packages": [
+    {
+      "registryType": "pypi",
+      "identifier": "cronometer-api-mcp",
+      "version": "0.1.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "CRONOMETER_USERNAME",
+          "description": "Your Cronometer account email",
+          "isRequired": true,
+          "isSecret": false
+        },
+        {
+          "name": "CRONOMETER_PASSWORD",
+          "description": "Your Cronometer account password",
+          "isRequired": true,
+          "isSecret": true
+        }
+      ]
+    }
+  ]
+}

cronometer_api_mcp-0.1.0/src/cronometer_api_mcp/__init__.py

@@ -0,0 +1,5 @@
+"""Cronometer MCP server using the mobile REST API."""
+
+from .client import CronometerClient, CronometerError
+
+__all__ = ["CronometerClient", "CronometerError"]