@webcraftstudio/mcp-server

MCP (Model Context Protocol) server for BOS360 — manage your entire business from AI assistants like Claude.

101 tools across 10 modules: Clients, Projects, Invoicing, Leads, Notes, Mindmaps, Calendar, Proposals, Messaging, and Expenses.

Installation

npm install -g @webcraftstudio/mcp-server

Or run directly with npx (no install needed):

npx @webcraftstudio/mcp-server

Setup

1. Get your API Key

1. Go to BOS360 → Settings → API Keys
2. Click Create API Key
3. Set permissions (use * for full access)
4. Copy the key (bos360_sk_...)

2. Configure Claude Desktop

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

{
  "mcpServers": {
    "bos360": {
      "command": "npx",
      "args": ["-y", "@webcraftstudio/mcp-server"],
      "env": {
        "BOS360_API_KEY": "bos360_sk_..."
      }
    }
  }
}

3. Configure Claude Code

claude mcp add bos360 -- npx -y @webcraftstudio/mcp-server

Then set the environment variable:

export BOS360_API_KEY="bos360_sk_..."

4. Configure VS Code / Cursor / Windsurf

Add the same configuration as Claude Desktop to your IDE's MCP settings.

Available Modules

| Module | Tools | Description | |--------|-------|-------------| | Clients | 13 | CRM: contacts, follow-ups, actions, stats | | Projects | 11 | Projects, milestones, status tracking | | Invoicing | 15 | Invoices, line items, payments, stats | | Leads | 14 | Lead pipeline, follow-ups, actions, proposals | | Notes | 10 | Notes & folders, linked to entities | | Mindmaps | 8 | Visual mindmaps with ReactFlow | | Calendar | 5 | Events & scheduling | | Proposals | 11 | Proposals/contracts with line items | | Messaging | 14 | Channels, messages, threads, reactions |

See MCP_TOOLS.md for the full tools reference.

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | BOS360_API_KEY | Yes | Your BOS360 API key (bos360_sk_...) | | CONVEX_URL | No | Override Convex deployment URL (defaults to production) |

Permissions

Each API key has scoped permissions. Use * for full access, or scope per module:

• clients.read, clients.write, clients.delete
• projects.read, projects.write, projects.delete
• invoices.read, invoices.write, invoices.delete
• leads.read, leads.write, leads.delete
• notes.read, notes.write, notes.delete
• mindmap.read, mindmap.write, mindmap.delete
• calendar.read, calendar.write, calendar.delete
• proposals.read, proposals.write, proposals.delete
• messaging.read, messaging.write, messaging.delete

License

MIT