CleanSlate MCP Server

MCP server for CleanSlate API - judgment-free nutrition tracking through AI assistants.

Overview

This MCP (Model Context Protocol) server enables AI assistants like Claude to interact with the CleanSlate API for nutrition tracking. It provides a conversational interface for logging food, viewing daily totals, and managing entries without the guilt and complexity of traditional diet apps.

Features

• Five core tools for food logging:
  • log_food: Add food entries with calories and protein
  • get_today_log: View all entries for today
  • delete_food_entry: Remove entries
  • edit_food_entry: Update existing entries
  • get_today_summary: Get daily totals
• Judgment-free error messages that maintain CleanSlate's anti-perfectionism philosophy
• Today-only tracking with automatic daily reset
• Type-safe TypeScript implementation

Installation

Quick Install (Recommended)

Install directly via npm and add to Claude Code in one command:

claude mcp add --transport stdio cleanslate \
  --env CLEANSLATE_API_KEY=your_api_key_here \
  --env CLEANSLATE_API_BASE_URL=https://your-instance.jinocenc.io/auth/graphql \
  -- npx -y cleanslate-mcp

Replace your_api_key_here with your CleanSlate API key (found in CleanSlate Settings > API Token) and your-instance.jinocenc.io with your CleanSlate instance URL.

Alternative: Install from Source

# Clone the repository
git clone https://github.com/Juxsta/cleanslate-mcp.git
cd cleanslate-mcp

# Install dependencies
pnpm install

# Build the project
pnpm build

# Add to Claude Code
claude mcp add --transport stdio cleanslate \
  --env CLEANSLATE_API_KEY=your_api_key_here \
  --env CLEANSLATE_API_BASE_URL=https://your-instance.jinocenc.io/auth/graphql \
  -- node /path/to/cleanslate-mcp/dist/index.js

Configuration

Getting Your API Key:

1. Open your CleanSlate instance (e.g., https://cleanslate.jinocenc.io)
2. Go to Settings
3. Find "API Token" in the Information section
4. Copy the token value

Finding Your Instance URL:

• If you're using the hosted version: https://cleanslate.jinocenc.io/auth/graphql
• If self-hosted: https://your-domain.com/auth/graphql

Development

# Build the project
pnpm build

# Run tests
pnpm test

# Run with coverage
pnpm test:coverage

# Lint code
pnpm lint

# Format code
pnpm format

Philosophy

This project aligns with CleanSlate's core values:

• Anti-Perfectionism: Easy to fix mistakes, no historical guilt
• Judgment-Free: Helpful error messages without blame
• Simplicity: Only track calories and protein
• Daily Reset: Focus on today, not the past

License

Apache 2.0 - See LICENSE file for details

Contributing

See CONTRIBUTING.md for contribution guidelines.