# Bonsai MCP

> Connects to Bonsai via Scalekit MCP to manage companies, contacts, projects, tasks, time entries, invoices, deals, and team members.

**URL:** https://caywork.com/learn/docs/node/bonsaimcp-node

## Content

The **Bonsai MCP Node** integrates securely with Bonsai's freelance business platform through the Scalekit MCP gateway. It enables your AI agent to manage companies, contacts, projects, tasks, time entries, invoices, deals, and team members.

## Parameters

### Required Parameters
* **action** (string): The target Bonsai MCP tool action to run. Must be one of the enabled actions:
  * `bonsaimcp_create_company`: Create a new company.
  * `bonsaimcp_create_contact`: Create a new contact.
  * `bonsaimcp_create_invoice`: Create a new invoice.
  * `bonsaimcp_create_invoice_item`: Create a new invoice item.
  * `bonsaimcp_create_project`: Create a new project.
  * `bonsaimcp_create_task`: Create a new task.
  * `bonsaimcp_create_time_entry`: Create a new time entry.
  * `bonsaimcp_get_task`: Retrieve a specific task.
  * `bonsaimcp_list_board_groups`: List board groups.
  * `bonsaimcp_list_companies`: List companies.
  * `bonsaimcp_list_contacts`: List contacts.
  * `bonsaimcp_list_deals`: List deals.
  * `bonsaimcp_list_invoices`: List invoices.
  * `bonsaimcp_list_projects`: List projects.
  * `bonsaimcp_list_tasks`: List tasks.
  * `bonsaimcp_list_team_members`: List team members.
  * `bonsaimcp_update_company`: Update an existing company.
  * `bonsaimcp_update_contact`: Update an existing contact.

### Optional Parameters
* **params** (object): A key-value dictionary containing action-specific inputs (e.g., `{'company_id': '12345', 'name': 'Acme Inc.'}`).

## Practical Use Cases
1. **Client and project management**: Create and update companies, contacts, projects, and tasks automatically from conversation context.
2. **Invoicing and time tracking**: Generate invoices, invoice items, and time entries, then retrieve related records for reporting.