Server

FreeNot checked

221 MCP tools across 26 practices for independent professionals. Clients, invoices, contracts.

by app.businys

GitHub Embed

About

221 MCP tools across 26 practices for independent professionals. Clients, invoices, contracts.

README

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

Sign in at businys.app
Go to Settings → API Keys
Create a new key with the scopes you need
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

from github.com/hiatys/businys-mcp

Install Server in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install app-businys

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add app-businys -- npx -y @businys/mcp-server

FAQ

Is Server MCP free?

Yes, Server MCP is free — one-click install via Unyly at no cost.

Does Server need an API key?

No, Server runs without API keys or environment variables.

Is Server hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Server in Claude Desktop, Claude Code or Cursor?

Open Server on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

GitHub

PRs, issues, code search, CI status

by GitHub

Filesystem

Secure file operations with configurable access controls.

by Community

Memory

Knowledge graph-based persistent memory system.