Simple Harvest MCP

Goal: Get your team using Claude Desktop to query Harvest data with minimal setup.

🎯 What This Is

• Claude Desktop integration for Harvest time tracking
• Team members just copy/paste one config block
• You deploy the API once, everyone benefits

🚀 Setup

1. Deploy the API (You do this once)

# Deploy to Google Cloud Run
gcloud run deploy harvest-api --source . --region us-central1

# Set environment variables
gcloud run services update harvest-api --region us-central1 \
  --set-env-vars HARVEST_ACCOUNT_ID=your_id,HARVEST_ACCESS_TOKEN=your_token,TEAM_API_KEY=random_key_123

2. Publish NPM Package (You do this once)

# Change package name in package.json to something unique
# Then publish
npm publish

3. Team Member Setup (Each person does this)

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

{
  "mcpServers": {
    "harvest": {
      "command": "npx",
      "args": ["-y", "@your-company/harvest-mcp"],
      "env": {
        "API_URL": "https://your-api-url.run.app",
        "API_KEY": "random_key_123"
      }
    }
  }
}

Done! Team members restart Claude Desktop and can ask:

• "What's our team utilization this week?"
• "Show me project summaries for the last month"

📁 Files

• api.py - FastAPI server for Cloud Run
• index.js - NPM package (MCP client)
• package.json - NPM configuration
• requirements.txt - Python dependencies

🔧 How It Works

1. User asks Claude a question about team data
2. Claude Desktop automatically downloads your NPM package
3. NPM package calls your Cloud Run API
4. API gets data from Harvest and returns it
5. User gets formatted response in Claude

That's it! Super simple architecture with minimal user setup.