Grocery Logger Server

A Model Context Protocol (MCP) server for logging and analyzing grocery purchases. Works with Claude Desktop to track prices, spending patterns, and purchase history.

Features

• Bulk add grocery items with timestamp, vendor, item name, category, price, quantity, and unit
• Query item prices with average price and purchase history
• List items by category with price statistics
• Analyze spending by vendor, category, or date range
• List categories to maintain consistency when logging

Installation

Requires Python 3.10+ and uv.

# Clone the repo
git clone <your-repo-url>
cd grocery_mcp

# Install dependencies
uv sync

Claude Desktop Configuration

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

{
  "mcpServers": {
    "grocery-logger": {
      "command": "/usr/local/bin/uv",
      "args": [
        "run",
        "--directory", "/path/to/grocery_mcp",
        "grocery-mcp"
      ]
    }
  }
}

Then restart Claude Desktop.

Available Tools

Tool	Description
add_grocery_items	Bulk add grocery purchases
query_item_price	Get price history and average for an item
list_items_by_category	List all items in a category with stats
query_spending	Analyze spending by vendor, category, or date
list_categories	List existing categories for consistency

Example Usage

Once configured, ask Claude:

• "Log these groceries: 2 lbs bananas $2.99, 1 gallon milk $4.50 from Costco"
• "What was the price of green onions?"
• "How much did I spend at Trader Joes this month?"
• "Show me all produce items I've bought"
• "What's my average spending by category?"

Data Storage

Grocery data is stored in data/grocery.db (SQLite). This file is gitignored to keep your personal data private.