businys-mcp

@businys/mcp-server

Official MCP server for Businys — the unified platform for independent professionals.

221 tools across 26 practices. Clients, invoices, contracts, bookings, programs, projects, and more — all accessible to any MCP-compatible AI agent.

Installation

Claude Desktop

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

{
  "mcpServers": {
    "businys": {
      "command": "npx",
      "args": ["@businys/mcp-server"],
      "env": {
        "HIATYS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Other MCP clients

npx @businys/mcp-server

Requires HIATYS_API_KEY environment variable.

Getting an API Key

1. Sign in at businys.app
2. Go to Settings → API Keys
3. Create a new key with the scopes you need
4. Paste it into your MCP client config

API access requires a paid plan (Starter $12/mo and above).

What's Included

Tools (221 total)

The server exposes tools for everything your Businys account has active:

| Practice | Tools | |---|---| | Photography | Clients, quotes, galleries, contracts, invoices, gear, licensing | | Fitness | Clients, programs, workouts, progress tracking, sessions | | Design | Projects, proposals, contracts, invoices, deliverables | | Brand | Brand guidelines, identity systems, deliverables | | Videography | Projects, shot lists, contracts, deliverables | | Yoga | Classes, memberships, bookings, packages | | Life Coaching | Sessions, programs, check-ins, goals | | Consulting | Engagements, deliverables, timesheets | | Tutoring | Students, sessions, progress, packages | | Music Lessons | Students, lesson plans, sessions, packages | | Online Courses | Courses, modules, enrollments, progress | | Wedding Planning | Weddings, vendors, timelines, budgets | | Social Media | Clients, campaigns, content calendars | | Hair Salon | Clients, appointments, services, packages | | Nail Tech | Clients, appointments, services, packages | | Massage Therapy | Clients, intake forms, packages, SOAP notes | | Tattoo | Clients, bookings, deposits, aftercare | | Cleaning | Properties, checklists, schedules, invoicing | | Landscaping | Properties, services, schedules, invoicing | | Pet Grooming | Pets, clients, appointments, services | | Newsletter | Subscribers, issues, sponsorships, analytics | | YouTube Creator | Videos, sponsors, analytics, revenue | | Podcasting | Episodes, guests, sponsors, analytics | | Copywriting | Clients, projects, briefs, deliverables | | Freelance Dev | Clients, projects, timesheets, invoices | | AI Consulting | Clients, engagements, prompt libraries |

Plus cross-practice tools: clients, invoices, contracts, bookings, assets, automations, bulk operations, and more.

Resources

• hiatys://context/current — Live business context snapshot
• hiatys://data/clients — Active client list
• hiatys://clients/{id} — Individual client details
• hiatys://context/{sections} — Selective context by section
• hiatys://profiles/{slug} — Public profile page data

Tool Discovery

Use the built-in get_manifest tool to see all available tools, groups, and resources for your account.

Environment Variables

| Variable | Required | Default | Description | |---|---|---|---| | HIATYS_API_KEY | Yes | — | Your Businys API key | | HIATYS_BASE_URL | No | https://businys.app | Override for self-hosted or staging |

Transport

This package runs as a stdio transport — suitable for Claude Desktop, Cursor, Cline, and other local MCP clients.

For HTTP/streamable-http transport, connect directly to https://businys.app/api/mcp using your API key as a Bearer token.

Data & Privacy

• All data lives in your Businys account
• The server proxies API calls — no data is stored by the MCP server process
• Canadian data residency (ca-central-1) — PIPEDA compliant
• Full data export available at any time from Settings

License

MIT — see LICENSE

Links

• Businys
• Documentation
• Issues
• MCP Server Card