Model Context Protocol

Your Grocery Data,
Inside Your AI Assistant

Connect Claude, ChatGPT, or any MCP-compatible AI to your GroceryTrack account. Ask about your receipts, spending trends, and nutrition facts — all in natural language.

URLhttps://grocerytrack.food/api/mcp
OAuth 2.1 + PKCEStreamable HTTP6 tools available

See It in Action

Watch how Claude uses GroceryTrack tools to answer real questions about your grocery data.

  • Ask about recent receipts and spending
  • Recall the trip notes you saved on past visits
  • Get nutrition facts for any grocery item
  • Break down spending by store or category

Available Tools

Six tools that give your AI full read access to your receipts, trip notes, and nutrition catalog.

lookup_nutrition

Public

Look up nutrition facts for any item in the catalog — calories, macros, vitamins, minerals, storage tips, and seasonality.

"What are the macros for chicken breast?"

list_nutrition_items

Public

Browse all available grocery items with nutrition data. Filter by category: Fruits, Vegetables, or Meat & Seafood.

"Show me all vegetables with nutrition data"

list_receipts

Auth required

List your recent grocery receipts with store name, date, total, item count, and a hasNotes flag for receipts you’ve annotated. Paginated up to 50 results.

"Show my last 5 grocery receipts"

get_receipt

Auth required

Get full details of a specific receipt — every line item with name, price, category, quantity, organic status, and any trip notes you’ve added.

"What did I buy at Trader Joe's last week?"

list_trip_notes

Auth required

Pull the free-form trip notes you add to receipts — product quality, price comparisons, packaging differences. Optionally filter by store (case-insensitive, normalized match).

"What did I say about Whole Foods strawberries last time?"

spending_summary

Auth required

Get a spending summary over any date range — total spent, trip count, average per trip, category breakdown, and store breakdown.

"How much did I spend on groceries in March?"

Setup Guide

Connect in under a minute. Pick your AI assistant below.

Claude Desktop

Step 1. Open Claude Desktop settings and navigate to the MCP Servers section, or edit your config file directly:

macOS
~/Library/Application Support/
Claude/claude_desktop_config.json
Windows
%APPDATA%\Claude\
claude_desktop_config.json

Step 2. Add the GroceryTrack server to your config:

claude_desktop_config.json
{
  "mcpServers": {
    "grocerytrack": {
      "url": "https://grocerytrack.food/api/mcp"
    }
  }
}

Step 3. Restart Claude Desktop. You'll be prompted to sign in with your Google account when Claude first tries to use a tool that requires authentication.

Claude Code (CLI)

Option A. Add as a project-scoped server via the CLI:

Terminal
claude mcp add grocerytrack \
  --transport http \
  "https://grocerytrack.food/api/mcp"

Option B. Or add it to your .mcp.json file:

.mcp.json
{
  "mcpServers": {
    "grocerytrack": {
      "type": "http",
      "url": "https://grocerytrack.food/api/mcp"
    }
  }
}

ChatGPT

Step 1. Open ChatGPT Settings (click your profile icon in the bottom-left).

Step 2. Navigate to Connected apps, then click Add MCP server (or "Add more tools").

Step 3. Paste the server URL and confirm:

MCP Server URL
https://grocerytrack.food/api/mcp

Step 4. You'll be redirected to sign in with Google to authorize access. Once connected, ChatGPT can use all six GroceryTrack tools.

Other MCP Clients

Any client that supports Streamable HTTP transport and OAuth 2.1 can connect. Point it at the server URL:

https://grocerytrack.food/api/mcp

The server publishes OAuth metadata at /.well-known/oauth-authorization-server and supports dynamic client registration (RFC 7591), so most clients can auto-configure.

What You Can Ask

Once connected, just talk to your AI naturally. Here are some ideas.

How much did I spend on groceries this month?
Show me my last 10 receipts.
What did I buy at Whole Foods on March 5th?
Summarize my trip notes for Trader Joe’s.
Which receipts have notes I should revisit?
Break down my spending by category for Q1.
Which store do I spend the most at?
What are the nutrition facts for salmon?
List all fruits with their calorie counts.
Compare my spending this month vs last month.

Authentication & Security

OAuth 2.1 with PKCE

Industry-standard authorization with Proof Key for Code Exchange. No secrets stored on your device.

Google Sign-In

Authenticate with the same Google account you use for GroceryTrack. No extra passwords.

Read-Only Access

All tools are read-only. Your AI can query data but cannot modify or delete anything.

Scoped Permissions

Tokens are scoped to read:receipts and read:nutrition. No access to account settings.

1-Hour Token Expiry

Access tokens expire after one hour. Re-authenticate anytime to revoke access.

Dynamic Registration

RFC 7591 dynamic client registration. No hardcoded client IDs or manual setup.

Don't Have a GroceryTrack Account Yet?

Sign up free, scan a few receipts, then connect your AI assistant to unlock the full power of your grocery data.

Get Started Free