Package Exports

american-cheese-mcp
american-cheese-mcp/api-index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (american-cheese-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

american-cheese-mcp

MCP (Model Context Protocol) server for Site Setups — a construction project management platform. Gives AI assistants like Claude full access to your projects, tasks, materials, labor, contacts, calendars, and more.

Quick Start

Option A: Use with `npx` (no install needed)

Add to your .mcp.json (Claude Code) or claude_desktop_config.json (Claude Desktop):

{
  "mcpServers": {
    "american-cheese": {
      "command": "npx",
      "args": ["-y", "american-cheese-mcp"],
      "env": {
        "API_BASE_URL": "https://app.sitesetups.com",
        "API_EMAIL": "your-email@example.com",
        "API_PASSWORD": "your-password"
      }
    }
  }
}

Option B: Global install

npm install -g american-cheese-mcp

Then reference it in your MCP config:

{
  "mcpServers": {
    "american-cheese": {
      "command": "american-cheese-mcp",
      "env": {
        "API_BASE_URL": "https://app.sitesetups.com",
        "API_EMAIL": "your-email@example.com",
        "API_PASSWORD": "your-password"
      }
    }
  }
}

Authentication

The server supports two auth methods:

Email/Password: Set API_EMAIL and API_PASSWORD — the server logs in automatically
API Token (if available): Set API_TOKEN instead

You can pass these as env in your MCP config (shown above) or create a .env file next to the package.

Available Tools (80+)

Category	Tools
Projects	create, list, get, update, delete, overview, summary, quick setup
Tasks	create, list, get, update, delete, search, batch create/update, clone
Subtasks	create, list, get, update, delete, budget
Categories	create, list, update, delete, bulk create, presets
Materials	create, list, get, update, delete, link to subtasks
Labor	create, list, get, update, delete
Contacts	create, list, get, update, delete, link to subtasks
Calendar	create, list, get, update, delete, create from task
Checklists	create, list, update, delete, blocker board
Attachments	create, list, get, update, delete
Budget	summary, by-category, subtask budget
Context (BMAD)	project/category/task context CRUD, templates, XML export
References	task references, subtask references, shared projects

Category Presets

Quick-start a project with preset categories:

home-builder — Residential construction
standard-construction — Commercial construction
software-development — Software dev lifecycle
ai-agent — AI/ML agent workflow
digital-marketing — Digital marketing campaigns
digital-marketing-plan — Marketing plan structure
marketing-sales — Marketing & sales pipeline
workout — Fitness tracking
bmad-agent-teams — BMAD methodology

Example Usage

Once connected, ask Claude things like:

"Create a new project called 'Kitchen Remodel' with the home-builder preset"
"Show me all tasks for project 5"
"Add 3 tasks to the Framing category"
"Get a budget summary for project 8"
"List all materials that need to be ordered"
"Log 8 hours of labor for John on task 12"

Troubleshooting

Auth errors — Verify email/password, ensure the account is active

Connection errors — Check that API_BASE_URL is reachable and has no trailing slash

Tools not showing — Restart Claude Code/Desktop after config changes

License

MIT