> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to MOCO

The MOCO connector lets your AI agent act in each user's MOCO account. Each user connects their own MOCO access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 59 tools.

**Authentication:** Bearer Token
**Categories:** Project Management, Accounting & Finance
**Tools:** 59: 33 read, 25 write, 1 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=MOCO)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the MOCO connection

   In **AgentKit > Connections**, create a MOCO connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'moco'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize MOCO:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'moco_activities_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "moco"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize MOCO:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="moco_activities_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their MOCO credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'moco_activities_list',
  toolInput: {},
  connector: 'moco',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="moco_activities_list",
    tool_input={},
    connection_name="moco",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `moco_activities_list`

List Activities · Read-only

List time tracking entries, filtered by dates, user, project, task, company or billing state.
Returns an array of objects with id, date, hours, description, billed, billable, invoice_id, tag.
Use moco_activities_list for timesheets and reports.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `billable` (`boolean`, optional): Filter by billable flag. Example: true
- `billed` (`boolean`, optional): Filter by billed flag. Example: false
- `company_id` (`integer`, optional): Company ID, from moco_companies_list. Example: 760253573
- `deal_id` (`string`, optional): Deal ID, from moco_deals_list. Example: 1234567
- `from` (`string`, optional): Start date, YYYY-MM-DD. Example: 2026-11-01
- `ids` (`string`, optional): Only these IDs, comma-separated. Example: 123,456
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `per_page` (`integer`, optional): Results per page (default 100). Example: 100
- `project_id` (`integer`, optional): Project ID, from moco_projects_list. Example: 944504145
- `remote_id` (`string`, optional): Single remote ID or comma-separated list of remote IDs. Example: abc123
- `sort_by` (`string`, optional): Sort field, optionally followed by desc. Example: created_at desc
- `tag` (`string`, optional): Single tag or comma-separated list of tags. Example: example
- `task_id` (`integer`, optional): Project task ID, from moco_project_tasks_list. Example: 1234567
- `term` (`string`, optional): Full-text search term. Example: website
- `to` (`string`, optional): End date, YYYY-MM-DD. Example: 2026-11-30
- `updated_after` (`string`, optional): Only records changed after this time, ISO 8601. Example: 2026-11-01T00:00:00Z
- `user_id` (`integer`, optional): User ID, from moco_users_list. Example: 933590696

Example input: `{}`

### `moco_activity_get`

Get Activity · Read-only

Get one time entry.
Returns an object with id, date, hours, description, billed, billable, invoice_id, tag, remote_service, remote_id, and more.
Use moco_activity_get for one entry.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `activity_id` (`integer`, required): Activity ID. Example: 123456

Example input: `{"activity_id":123456}`

### `moco_comments_list`

List Comments · Read-only

List comments on companies, contacts, deals, projects, offers and invoices.
Returns an array of objects with id, commentable_id, commentable_type, text, manual, created_at, updated_at, user.
Use moco_comments_list to read notes on a record.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `commentable_id` (`integer`, optional): ID of the record. Example: 944504145
- `commentable_type` (`string`, optional): Type of record. One of: Company, Contact, Deal, DeliveryNote, Expense, Invoice, InvoiceBookkeepingExport, InvoiceDeletion, InvoiceReminder, Offer, OfferConfirmation, Project, ProjectGroup, Purchase, PurchaseBookkeepingExport, PurchaseDraft, Receipt, ReceiptRefundRequest, RecurringExpense, Unit, User, UserHolidayRequest. Example: Project. One of: `Company`, `Contact`, `Deal`, `DeliveryNote`, `Expense`, `Invoice`, `InvoiceBookkeepingExport`, `InvoiceDeletion`, `InvoiceReminder`, `Offer`, `OfferConfirmation`, `Project`, `ProjectGroup`, `Purchase`, `PurchaseBookkeepingExport`, `PurchaseDraft`, `Receipt`, `ReceiptRefundRequest`, `RecurringExpense`, `Unit`, `User`, `UserHolidayRequest`.
- `ids` (`string`, optional): Only these IDs, comma-separated. Example: 123,456
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `per_page` (`integer`, optional): Results per page (default 100). Example: 100
- `updated_after` (`string`, optional): Only records changed after this time, ISO 8601. Example: 2026-11-01T00:00:00Z
- `user_id` (`integer`, optional): User ID, from moco_users_list. Example: 933590696

Example input: `{}`

### `moco_companies_list`

List Companies · Read-only

List customers, suppliers and organizations.
Returns an array of objects with id, type, identifier, name, website, email, billing_email_cc, phone.
Use moco_companies_list to find a company ID. Use moco_company_get for one company.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `identifier` (`string`, optional): Identifier (number); MOCO generates one if empty and numbering is automatic. Example: P2611-001
- `ids` (`string`, optional): Only these IDs, comma-separated. Example: 123,456
- `include_archived` (`boolean`, optional): If true, include archived records. Example: false
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `per_page` (`integer`, optional): Results per page (default 100). Example: 100
- `tags` (`string`, optional): Tags, comma-separated in queries or an array in bodies. Example: ["Retainer"]
- `term` (`string`, optional): Full-text search term. Example: website
- `type` (`string`, optional): Company type. One of: customer, supplier, organization. Example: customer. One of: `customer`, `supplier`, `organization`.
- `updated_after` (`string`, optional): Only records changed after this time, ISO 8601. Example: 2026-11-01T00:00:00Z

Example input: `{}`

### `moco_company_get`

Get Company · Read-only

Get one company with its address, billing settings and projects.
Returns an object with id, type, identifier, name, website, email, billing_email_cc, phone, fax, address, and more.
Use moco_company_get for one company.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company_id` (`integer`, required): Company ID. Example: 123456

Example input: `{"company_id":123456}`

### `moco_contact_get`

Get Contact · Read-only

Get one contact person.
Returns an object with id, gender, firstname, lastname, title, job_position, mobile_phone, work_fax, work_phone, work_email, and more.
Use moco_contact_get for one contact.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`integer`, required): Contact ID. Example: 123456

Example input: `{"contact_id":123456}`

### `moco_contacts_list`

List Contacts · Read-only

List contact people.
Returns an array of objects with id, gender, firstname, lastname, title, job_position, mobile_phone, work_fax.
Use moco_contacts_list to find a contact.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ids` (`string`, optional): Only these IDs, comma-separated. Example: 123,456
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `per_page` (`integer`, optional): Results per page (default 100). Example: 100
- `phone` (`string`, optional): Phone number. Example: +41 44 123 45 67
- `tags` (`string`, optional): Tags, comma-separated in queries or an array in bodies. Example: ["Retainer"]
- `term` (`string`, optional): Full-text search term. Example: website
- `updated_after` (`string`, optional): Only records changed after this time, ISO 8601. Example: 2026-11-01T00:00:00Z

Example input: `{}`

### `moco_deal_categories_list`

List Deal Stages · Read-only

List the deal categories (pipeline stages) with their probability.
Returns an array of objects with id, name, probability, created_at, updated_at.
Use moco_deal_categories_list to find a deal_category_id.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ids` (`string`, optional): Only these IDs, comma-separated. Example: 123,456
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `per_page` (`integer`, optional): Results per page (default 100). Example: 100
- `updated_after` (`string`, optional): Only records changed after this time, ISO 8601. Example: 2026-11-01T00:00:00Z

Example input: `{}`

### `moco_deal_get`

Get Deal · Read-only

Get one deal.
Returns an object with id, name, status, reminder_date, closed_on, money, currency, info, tags, custom_properties, and more.
Use moco_deal_get for one deal.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `deal_id` (`integer`, required): Deal ID. Example: 123456

Example input: `{"deal_id":123456}`

### `moco_deals_list`

List Deals · Read-only

List deals (leads and opportunities).
Returns an array of objects with id, name, status, reminder_date, closed_on, money, currency, info.
Use moco_deals_list to review the sales pipeline.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `closed_from` (`string`, optional): Closed date range start. Format: YYYY-MM-DD (e.g. 2026-01-01). Example: 2026-01-31
- `closed_to` (`string`, optional): Closed date range end. Format: YYYY-MM-DD (e.g. 2026-01-31). Example: 2026-01-31
- `company_id` (`integer`, optional): Company ID, from moco_companies_list. Example: 760253573
- `ids` (`string`, optional): Only these IDs, comma-separated. Example: 123,456
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `per_page` (`integer`, optional): Results per page (default 100). Example: 100
- `person_id` (`integer`, optional): Contact person ID. Example: 123456
- `status` (`string`, optional): Deal status. One of: potential, pending, won, lost, dropped. Example: pending. One of: `potential`, `pending`, `won`, `lost`, `dropped`.
- `tags` (`string`, optional): Tags, comma-separated in queries or an array in bodies. Example: ["Retainer"]
- `updated_after` (`string`, optional): Only records changed after this time, ISO 8601. Example: 2026-11-01T00:00:00Z

Example input: `{}`

### `moco_invoice_get`

Get Invoice · Read-only

Get one invoice with its items and payments.
Returns items[] (each with id, type, title, revenue_category, description, quantity, unit, unit_price) plus id, customer_id, project_id, offer_id.
Use moco_invoice_get for one invoice.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `invoice_id` (`integer`, required): Invoice ID. Example: 123456

Example input: `{"invoice_id":123456}`

### `moco_invoice_payments_list`

List Invoice Payments · Read-only

List recorded invoice payments.
Returns an array of objects with id, date, invoice, paid_total, paid_total_in_account_currency, currency, description, created_at.
Use moco_invoice_payments_list to see what customers paid.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `date_from` (`string`, optional): Payment date range start. Format: YYYY-MM-DD (e.g. 2026-01-01). Example: 2026-01-31
- `date_to` (`string`, optional): Payment date range end. Format: YYYY-MM-DD (e.g. 2026-01-31). Example: 2026-01-31
- `ids` (`string`, optional): Only these IDs, comma-separated. Example: 123,456
- `invoice_id` (`string`, optional): Only payments of this invoice. Example: 123456
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `per_page` (`integer`, optional): Results per page (default 100). Example: 100
- `updated_after` (`string`, optional): Only records changed after this time, ISO 8601. Example: 2026-11-01T00:00:00Z

Example input: `{}`

### `moco_invoices_list`

List Invoices · Read-only

List invoices, filtered by status, dates, company or project.
Returns an array of objects with id, customer_id, project_id, offer_id, identifier, date, due_date, service_period.
Use moco_invoices_list to find invoices. Use moco_invoice_get for one.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company_id` (`string`, optional): Company ID, from moco_companies_list. Example: 760253573
- `date_from` (`string`, optional): Invoice date range start. Format: YYYY-MM-DD (e.g. 2026-01-01). Example: 2026-01-31
- `date_to` (`string`, optional): Invoice date range end. Format: YYYY-MM-DD (e.g. 2026-01-31). Example: 2026-01-31
- `identifier` (`string`, optional): Identifier (number); MOCO generates one if empty and numbering is automatic. Example: P2611-001
- `ids` (`string`, optional): Only these IDs, comma-separated. Example: 123,456
- `include_disregarded` (`boolean`, optional): If true, include disregarded invoices. Example: false
- `not_booked` (`boolean`, optional): If true, only records not yet exported to bookkeeping. Example: true
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `per_page` (`integer`, optional): Results per page (default 100). Example: 100
- `project_id` (`string`, optional): Project ID, from moco_projects_list. Example: 944504145
- `service_period_from` (`string`, optional): Service period start, YYYY-MM-DD. Example: 2026-11-01
- `service_period_to` (`string`, optional): Service period end, YYYY-MM-DD. Example: 2026-11-30
- `sort_by` (`string`, optional): Sort field, optionally followed by desc. Example: created_at desc
- `status` (`string`, optional): Invoice status. One of: draft, created, sent, partially_paid, paid, overdue, ignored. Example: overdue
- `tags` (`string`, optional): Tags, comma-separated in queries or an array in bodies. Example: ["Retainer"]
- `term` (`string`, optional): Full-text search term. Example: website
- `updated_after` (`string`, optional): Only records changed after this time, ISO 8601. Example: 2026-11-01T00:00:00Z

Example input: `{}`

### `moco_offer_get`

Get Offer · Read-only

Get one offer with its items.
Returns items[] (each with id, type, title, revenue_category, description, quantity, unit, unit_price) plus id, invoice_id, identifier, date.
Use moco_offer_get for one offer.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `offer_id` (`integer`, required): Offer ID. Example: 123456

Example input: `{"offer_id":123456}`

### `moco_offers_list`

List Offers · Read-only

List offers (quotes).
Returns an array of objects with id, invoice_id, identifier, date, due_date, title, recipient_address, currency.
Use moco_offers_list to find an offer.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company_id` (`string`, optional): Company ID, from moco_companies_list. Example: 760253573
- `deal_id` (`string`, optional): Deal ID, from moco_deals_list. Example: 1234567
- `from` (`string`, optional): Start date, YYYY-MM-DD. Example: 2026-11-01
- `identifier` (`string`, optional): Identifier (number); MOCO generates one if empty and numbering is automatic. Example: P2611-001
- `ids` (`string`, optional): Only these IDs, comma-separated. Example: 123,456
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `per_page` (`integer`, optional): Results per page (default 100). Example: 100
- `project_id` (`string`, optional): Project ID, from moco_projects_list. Example: 944504145
- `sort_by` (`string`, optional): Sort field, optionally followed by desc. Example: created_at desc
- `status` (`string`, optional): Offer status. One of: created, sent, accepted, partially_billed, billed, archived. Example: sent. One of: `created`, `sent`, `accepted`, `partially_billed`, `billed`, `archived`.
- `tags` (`string`, optional): Tags, comma-separated in queries or an array in bodies. Example: ["Retainer"]
- `to` (`string`, optional): End date, YYYY-MM-DD. Example: 2026-11-30
- `updated_after` (`string`, optional): Only records changed after this time, ISO 8601. Example: 2026-11-01T00:00:00Z

Example input: `{}`

### `moco_planning_entries_list`

List Planning Entries · Read-only

List resource planning entries (planned hours per user and project).
Returns an array of objects with id, title, starts_on, ends_on, hours_per_day, comment, symbol, color.
Use moco_planning_entries_list to see capacity planning.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `deal_id` (`string`, optional): Deal ID, from moco_deals_list. Example: 1234567
- `ids` (`string`, optional): Only these IDs, comma-separated. Example: 123,456
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `per_page` (`integer`, optional): Results per page (default 100). Example: 100
- `period` (`string`, optional): Date range as YYYY-MM-DD:YYYY-MM-DD. Example: 2026-11-01:2026-11-30
- `project_id` (`string`, optional): Project ID, from moco_projects_list. Example: 944504145
- `updated_after` (`string`, optional): Only records changed after this time, ISO 8601. Example: 2026-11-01T00:00:00Z
- `user_id` (`string`, optional): User ID, from moco_users_list. Example: 933590696

Example input: `{}`

### `moco_profile_get`

Get Profile · Read-only

Get the profile of the user the API key belongs to.
Returns an object with id, email, full_name, first_name, last_name, active, external, avatar_url, unit, created_at, and more.
Use moco_profile_get to check the connection.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `moco_project_contracts_list`

List Project Staff · Read-only

List the staff assigned to a project (contracts) with their budgets and rates.
Returns an array of objects with id, user_id, firstname, lastname, billable, active, budget, hourly_rate.
Use moco_project_contracts_list to see who works on a project.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID, from moco_projects_list. Example: 944504145
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `per_page` (`integer`, optional): Results per page (default 100). Example: 100
- `updated_after` (`string`, optional): Only records changed after this time, ISO 8601. Example: 2026-11-01T00:00:00Z

Example input: `{"project_id":944504145}`

### `moco_project_expenses_list`

List Project Expenses · Read-only

List the additional services (expenses) of a project.
Returns an array of objects with id, date, title, description, quantity, unit, unit_price, unit_cost.
Use moco_project_expenses_list to review billable extras.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID, from moco_projects_list. Example: 944504145
- `billable` (`boolean`, optional): Billable flag. Example: true
- `billed` (`boolean`, optional): Billed flag. Example: false
- `budget_relevant` (`boolean`, optional): If true, counts against the project budget. Example: true
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `per_page` (`integer`, optional): Results per page (default 100). Example: 100
- `updated_after` (`string`, optional): Only records changed after this time, ISO 8601. Example: 2026-11-01T00:00:00Z
- `user_id` (`integer`, optional): User ID, from moco_users_list. Example: 933590696

Example input: `{"project_id":944504145}`

### `moco_project_get`

Get Project · Read-only

Get one project with its customer, budget, tasks and contracts.
Returns an object with id, identifier, name, active, billable, fixed_price, retainer, start_date, finish_date, currency, and more.
Use moco_project_get for one project.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID. Example: 123456

Example input: `{"project_id":123456}`

### `moco_project_report_get`

Get Project Report · Read-only

Get the project business report: budget, hours, costs, revenue and progress.
Returns the JSON response from the API.
Use moco_project_report_get to check project health.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID. Example: 123456

Example input: `{"project_id":123456}`

### `moco_project_tasks_list`

List Project Tasks · Read-only

List the tasks (service types) of a project.
Returns an array of objects with id, name, description, billable, active, budget, hourly_rate, revenue_category.
Use moco_project_tasks_list to find a task_id for time tracking.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID, from moco_projects_list. Example: 944504145
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `per_page` (`integer`, optional): Results per page (default 100). Example: 100
- `updated_after` (`string`, optional): Only records changed after this time, ISO 8601. Example: 2026-11-01T00:00:00Z

Example input: `{"project_id":944504145}`

### `moco_projects_assigned_list`

List My Projects · Read-only

List the projects the API key user is assigned to, with their tasks.
Returns an array of objects with id, identifier, name, active, billable, customer, tasks, contract.
Use moco_projects_assigned_list to find a project and task to track time on.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `active` (`boolean`, optional): Filter or set the active flag. Example: true

Example input: `{}`

### `moco_projects_list`

List Projects · Read-only

List projects, filtered by company, leader, tags, dates or text.
Returns an array of objects with id, identifier, name, active, billable, fixed_price, retainer, start_date.
Use moco_projects_list to find a project. Use moco_projects_assigned_list for your own projects.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company_id` (`string`, optional): Company ID, from moco_companies_list. Example: 760253573
- `deal_id` (`string`, optional): Deal ID, from moco_deals_list. Example: 1234567
- `identifier` (`string`, optional): Identifier (number); MOCO generates one if empty and numbering is automatic. Example: P2611-001
- `ids` (`string`, optional): Only these IDs, comma-separated. Example: 123,456
- `include_archived` (`boolean`, optional): If true, include archived projects. Example: false
- `leader_id` (`string`, optional): Project leader user ID. Example: 933590696
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `per_page` (`integer`, optional): Results per page (default 100). Example: 100
- `sort_by` (`string`, optional): Sort field, optionally followed by desc. Example: created_at desc
- `tags` (`string`, optional): Tags, comma-separated in queries or an array in bodies. Example: ["Retainer"]
- `term` (`string`, optional): Full-text search term. Example: website
- `updated_after` (`string`, optional): Only records changed after this time, ISO 8601. Example: 2026-11-01T00:00:00Z

Example input: `{}`

### `moco_purchase_get`

Get Purchase · Read-only

Get one purchase.
Returns items[] (each with id, title, net_total, tax_total, tax, vat, tax_included, ksk_relevant) plus id, identifier, receipt_identifier, title.
Use moco_purchase_get for one purchase.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `purchase_id` (`integer`, required): Purchase ID. Example: 123456

Example input: `{"purchase_id":123456}`

### `moco_purchases_list`

List Purchases · Read-only

List purchases (supplier invoices and receipts).
Returns an array of objects with id, identifier, receipt_identifier, title, info, iban, reference, date.
Use moco_purchases_list to review spending.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `approval_status` (`string`, optional): Approval status. One of: none, approved, denied, pending. Example: approved. One of: `none`, `approved`, `denied`, `pending`.
- `approver_user_id` (`integer`, optional): Approver user ID. Example: 933590696
- `category_id` (`integer`, optional): Purchase category ID. Example: 12
- `company_id` (`integer`, optional): Company ID, from moco_companies_list. Example: 760253573
- `date` (`string`, optional): Date, YYYY-MM-DD. Example: 2026-11-16
- `date_from` (`string`, optional): Purchase date range start. Format: YYYY-MM-DD (e.g. 2026-01-01). See also date_to. Example: 2026-01-31
- `date_to` (`string`, optional): Purchase date range end. Format: YYYY-MM-DD (e.g. 2026-01-31). See also date_from. Example: 2026-01-31
- `id` (`string`, optional): Legacy alias for filtering by purchase ID (single ID or comma-separated list). Example: abc123
- `identifier` (`string`, optional): Identifier (number); MOCO generates one if empty and numbering is automatic. Example: P2611-001
- `ids` (`string`, optional): Only these IDs, comma-separated. Example: 123,456
- `not_booked` (`boolean`, optional): If true, only records not yet exported to bookkeeping. Example: true
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `partially_paid` (`boolean`, optional): If true, the payment covers only part of the invoice. Example: false
- `payment_method` (`string`, optional): Payment method. One of: bank_transfer, direct_debit, credit_card, paypal, cash, bank_transfer_swiss_qr_esr. Example: bank_transfer. One of: `bank_transfer`, `direct_debit`, `credit_card`, `paypal`, `cash`, `bank_transfer_swiss_qr_esr`.
- `per_page` (`integer`, optional): Results per page (default 100). Example: 100
- `receipt_identifier` (`string`, optional): Receipt number. Example: R-2026-001
- `status` (`string`, optional): Status. One of: pending, archived. Example: pending. One of: `pending`, `archived`.
- `tag_ids` (`string`, optional): Comma-separated list of tag IDs. Example: abc123
- `tags` (`string`, optional): Tags, comma-separated in queries or an array in bodies. Example: ["Retainer"]
- `term` (`string`, optional): Full-text search term. Example: website
- `unpaid` (`boolean`, optional): If true, only unpaid purchases. Example: true
- `updated_after` (`string`, optional): Only records changed after this time, ISO 8601. Example: 2026-11-01T00:00:00Z
- `user_id` (`integer`, optional): User ID, from moco_users_list. Example: 933590696

Example input: `{}`

### `moco_report_utilization_get`

Get Utilization Report · Read-only

Get daily target and billable hours per user for a date range.
Returns an array of objects with date, user_id, target_hours, billable_hours, unbillable_hours, billable_seconds, unbillable_seconds.
Use moco_report_utilization_get to check team utilization.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from` (`string`, optional): Start date, YYYY-MM-DD. Example: 2026-11-01
- `to` (`string`, optional): End date, YYYY-MM-DD. Example: 2026-11-30

Example input: `{}`

### `moco_schedules_list`

List Absences · Read-only

List absences (holidays, sickness, public holidays) per user and day.
Returns an array of objects with id, date, comment, am, pm, symbol, assignment, user.
Use moco_schedules_list to check who is off.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `absence_code` (`string`, optional): Filter by absence code: 1 (unplannable absence), 2 (public holiday), 3 (sick day), 4 (holiday), 5 (absence). Comma-separated values are supported (e.g. 3,4). Example: example
- `from` (`string`, optional): Start date, YYYY-MM-DD. Example: 2026-11-01
- `ids` (`string`, optional): Only these IDs, comma-separated. Example: 123,456
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `per_page` (`integer`, optional): Results per page (default 100). Example: 100
- `to` (`string`, optional): End date, YYYY-MM-DD. Example: 2026-11-30
- `updated_after` (`string`, optional): Only records changed after this time, ISO 8601. Example: 2026-11-01T00:00:00Z
- `user_id` (`integer`, optional): User ID, from moco_users_list. Example: 933590696

Example input: `{}`

### `moco_tags_list`

List Tags · Read-only

List tags (labels) in the account.
Returns an array of objects with id, name, color, context, created_at, updated_at.
Use moco_tags_list to find tags for filters.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `context` (`string`, optional): Tag context. One of: Company, Contact, Project, Deal, Purchase, Invoice, Offer, User. Example: Company. One of: `Company`, `Contact`, `Project`, `Deal`, `Purchase`, `Invoice`, `Offer`, `User`.
- `ids` (`string`, optional): Only these IDs, comma-separated. Example: 123,456
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `per_page` (`integer`, optional): Results per page (default 100). Example: 100
- `updated_after` (`string`, optional): Only records changed after this time, ISO 8601. Example: 2026-11-01T00:00:00Z

Example input: `{}`

### `moco_units_list`

List Teams · Read-only

List teams (units) with their members.
Returns an array of objects with id, name, custom_properties, users, created_at, updated_at.
Use moco_units_list to see team structure.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ids` (`string`, optional): Only these IDs, comma-separated. Example: 123,456
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `per_page` (`integer`, optional): Results per page (default 100). Example: 100
- `updated_after` (`string`, optional): Only records changed after this time, ISO 8601. Example: 2026-11-01T00:00:00Z

Example input: `{}`

### `moco_user_get`

Get User · Read-only

Get one user.
Returns an object with id, firstname, lastname, active, extern, email, mobile_phone, work_phone, home_address, info, and more.
Use moco_user_get for one user.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `user_id` (`integer`, required): User ID. Example: 123456

Example input: `{"user_id":123456}`

### `moco_user_holidays_list`

List User Holidays · Read-only

List holiday entitlements per user and year.
Returns an array of objects with id, year, title, days, hours, user, creator, created_at.
Use moco_user_holidays_list to check vacation days.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ids` (`string`, optional): Only these IDs, comma-separated. Example: 123,456
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `per_page` (`integer`, optional): Results per page (default 100). Example: 100
- `updated_after` (`string`, optional): Only records changed after this time, ISO 8601. Example: 2026-11-01T00:00:00Z
- `user_id` (`integer`, optional): User ID, from moco_users_list. Example: 933590696
- `year` (`integer`, optional): Year. Example: 2026

Example input: `{}`

### `moco_users_list`

List Users · Read-only

List the staff users of the account.
Returns an array of objects with id, firstname, lastname, active, extern, email, mobile_phone, work_phone.
Use moco_users_list to find a user ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `email` (`string`, optional): Email address. Example: info@acme.ch
- `ids` (`string`, optional): Only these IDs, comma-separated. Example: 123,456
- `include_archived` (`boolean`, optional): If true, include archived users. Example: false
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `per_page` (`integer`, optional): Results per page (default 100). Example: 100
- `sort_by` (`string`, optional): Sort field, optionally followed by desc. Example: created_at desc
- `tags` (`string`, optional): Tags, comma-separated in queries or an array in bodies. Example: ["Retainer"]
- `updated_after` (`string`, optional): Only records changed after this time, ISO 8601. Example: 2026-11-01T00:00:00Z

Example input: `{}`

### `moco_activity_create`

Create Activity · Write

Track time on a project task for the API key user.
Returns an object with id, date, hours, description, billed, billable, invoice_id, tag, remote_service, remote_id, and more.
Use moco_activity_create to log hours.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `date` (`string`, required): Date, YYYY-MM-DD. Example: 2026-11-16
- `project_id` (`integer`, required): Project ID, from moco_projects_list. Example: 944504145
- `task_id` (`integer`, required): Project task ID, from moco_project_tasks_list. Example: 1234567
- `billable` (`boolean`, optional): If true, the time is billable. Example: true
- `description` (`string`, optional): What was done. Example: Kick-off workshop
- `seconds` (`integer`, optional): Duration in seconds. Example: 5400
- `tag` (`string`, optional): Free-text tag. Example: meeting

Example input: `{"date":"<date>","project_id":944504145,"task_id":1234567}`

### `moco_activity_timer_start`

Start Timer · Write

Start the timer on a time entry of today.
Returns an object with id, date, hours, description, billed, billable, invoice_id, tag, remote_service, remote_id, and more.
Use moco_activity_timer_start to track time live. Use moco_activity_timer_stop to stop.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `activity_id` (`integer`, required): Activity ID. Example: 123456

Example input: `{"activity_id":123456}`

### `moco_activity_timer_stop`

Stop Timer · Write

Stop the running timer on a time entry.
Returns an object with id, date, hours, description, billed, billable, invoice_id, tag, remote_service, remote_id, and more.
Use moco_activity_timer_stop after moco_activity_timer_start.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `activity_id` (`integer`, required): Activity ID. Example: 123456

Example input: `{"activity_id":123456}`

### `moco_activity_update`

Update Activity · Write

Update a time entry.
Returns an object with id, date, hours, description, billed, billable, invoice_id, tag, remote_service, remote_id, and more.
Use moco_activity_update to correct logged hours.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `activity_id` (`integer`, required): Activity ID. Example: 123456
- `billable` (`boolean`, optional): Billable flag. Example: true
- `company_id` (`integer`, optional): Company ID, from moco_companies_list. Example: 760253573
- `date` (`string`, optional): Date, YYYY-MM-DD. Example: 2026-11-16
- `description` (`string`, optional): What was done. Example: Kick-off workshop
- `project_id` (`integer`, optional): Project ID, from moco_projects_list. Example: 944504145
- `seconds` (`integer`, optional): Duration in seconds. Example: 7200
- `tag` (`string`, optional): Optional activity tag label. Example: example
- `task_id` (`integer`, optional): Project task ID, from moco_project_tasks_list. Example: 1234567

Example input: `{"activity_id":123456}`

### `moco_comment_create`

Create Comment · Write

Add a comment to a company, contact, deal, project, offer or invoice.
Returns an object with id, commentable_id, commentable_type, text, manual, created_at, updated_at, user, impersonating_user.
Use moco_comment_create to leave a note on a record.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `commentable_id` (`integer`, optional): ID of the record. Example: 944504145
- `commentable_type` (`string`, optional): Type of record. One of: Company, Contact, Deal, DeliveryNote, Expense, Invoice, InvoiceBookkeepingExport, InvoiceDeletion, InvoiceReminder, Offer, OfferConfirmation, Project, ProjectGroup, Purchase, PurchaseBookkeepingExport, PurchaseDraft, Receipt, ReceiptRefundRequest, RecurringExpense, Unit, User, UserHolidayRequest. Example: Project. One of: `Company`, `Contact`, `Deal`, `DeliveryNote`, `Expense`, `Invoice`, `InvoiceBookkeepingExport`, `InvoiceDeletion`, `InvoiceReminder`, `Offer`, `OfferConfirmation`, `Project`, `ProjectGroup`, `Purchase`, `PurchaseBookkeepingExport`, `PurchaseDraft`, `Receipt`, `ReceiptRefundRequest`, `RecurringExpense`, `Unit`, `User`, `UserHolidayRequest`.
- `text` (`string`, optional): Comment text (HTML allowed). Example: Customer approved the design.

Example input: `{}`

### `moco_company_archive`

Archive Company · Write

Archive a company.
Returns an object with id, type, identifier, name, website, email, billing_email_cc, phone, fax, address, and more.
Use moco_company_archive to hide a company that is no longer active.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company_id` (`integer`, required): Company ID. Example: 123456

Example input: `{"company_id":123456}`

### `moco_company_create`

Create Company · Write

Create a customer, supplier or organization.
Returns an object with id, type, identifier, name, website, email, billing_email_cc, phone, fax, address, and more.
Use moco_company_create for a new company.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Company name. Example: Acme GmbH
- `type` (`string`, required): Company type. One of: customer, supplier, organization. Example: customer. One of: `customer`, `supplier`, `organization`.
- `address` (`string`, optional): Postal address, one line per line break. Example: Acme GmbH
Hauptstrasse 1
8000 Zürich
- `billing_email_cc` (`string`, optional): CC address for invoice emails. Example: accounting@acme.ch
- `country_code` (`string`, optional): ISO country code. Example: CH
- `currency` (`string`, optional): Currency code. Example: EUR
- `email` (`string`, optional): Email address. Example: info@acme.ch
- `iban` (`string`, optional): IBAN. Example: CH9300762011623852957
- `identifier` (`string`, optional): Identifier (number); MOCO generates one if empty and numbering is automatic. Example: P2611-001
- `info` (`string`, optional): Internal notes. Example: Key account
- `invoice_due_days` (`integer`, optional): Payment term in days. Example: 30
- `phone` (`string`, optional): Phone number. Example: +41 44 123 45 67
- `tags` (`array`, optional): Tags, comma-separated in queries or an array in bodies. Example: ["Retainer"]
- `user_id` (`integer`, optional): Responsible user ID. Example: 933590696
- `vat_identifier` (`string`, optional): VAT number. Example: CHE-123.456.789 MWST
- `website` (`string`, optional): Website. Example: https://www.acme.ch

Example input: `{"name":"<name>","type":"customer"}`

### `moco_company_update`

Update Company · Write

Update a company; only the fields you send change.
Returns an object with id, type, identifier, name, website, email, billing_email_cc, phone, fax, address, and more.
Use moco_company_update to edit a company.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `company_id` (`integer`, required): Company ID. Example: 123456
- `address` (`string`, optional): Postal address, one line per line break. Example: Acme GmbH
Hauptstrasse 1
8000 Zürich
- `billing_email_cc` (`string`, optional): CC address for invoice emails. Example: accounting@acme.ch
- `country_code` (`string`, optional): ISO country code. Example: CH
- `currency` (`string`, optional): Currency code. Example: EUR
- `email` (`string`, optional): Email address. Example: info@acme.ch
- `iban` (`string`, optional): IBAN. Example: CH9300762011623852957
- `identifier` (`string`, optional): Identifier (number); MOCO generates one if empty and numbering is automatic. Example: P2611-001
- `info` (`string`, optional): Internal notes. Example: Key account
- `invoice_due_days` (`integer`, optional): Payment term in days. Example: 30
- `name` (`string`, optional): Company name. Example: Acme GmbH
- `phone` (`string`, optional): Phone number. Example: +41 44 123 45 67
- `tags` (`array`, optional): Tags, comma-separated in queries or an array in bodies. Example: ["Retainer"]
- `user_id` (`integer`, optional): User ID, from moco_users_list. Example: 933590696
- `vat_identifier` (`string`, optional): VAT number. Example: CHE-123.456.789 MWST
- `website` (`string`, optional): Website. Example: https://www.acme.ch

Example input: `{"company_id":123456}`

### `moco_contact_create`

Create Contact · Write

Create a contact person, optionally linked to a company.
Returns an object with id, gender, firstname, lastname, title, job_position, mobile_phone, work_fax, work_phone, work_email, and more.
Use moco_contact_create for a new contact.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `birthday` (`string`, optional): Birthday, YYYY-MM-DD. Example: 1985-04-12
- `company_id` (`integer`, optional): Company ID, from moco_companies_list. Example: 760253573
- `firstname` (`string`, optional): First name. Example: Anna
- `gender` (`string`, optional): Gender. One of: F, M, U. Example: F. One of: `U`, `M`, `F`.
- `info` (`string`, optional): Internal notes. Example: Key account
- `job_position` (`string`, optional): Job title. Example: CTO
- `lastname` (`string`, optional): Last name. Example: Muster
- `mobile_phone` (`string`, optional): Mobile phone. Example: +41 79 123 45 67
- `name` (`string`, optional): Name. Example: Website relaunch
- `salutation` (`string`, optional): Salutation used in letters and documents. Example: Dear Anna
- `tags` (`array`, optional): Tags, comma-separated in queries or an array in bodies. Example: ["Retainer"]
- `title` (`string`, optional): Title. Example: Dr.
- `user_id` (`integer`, optional): User ID, from moco_users_list. Example: 933590696
- `work_address` (`string`, optional): Work address. Example: Hauptstrasse 1, 8000 Zürich
- `work_email` (`string`, optional): Work email. Example: anna@acme.ch
- `work_phone` (`string`, optional): Work phone. Example: +41 44 123 45 67

Example input: `{}`

### `moco_contact_update`

Update Contact · Write

Update a contact person.
Returns an object with id, gender, firstname, lastname, title, job_position, mobile_phone, work_fax, work_phone, work_email, and more.
Use moco_contact_update to edit a contact.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`integer`, required): Contact ID. Example: 123456
- `birthday` (`string`, optional): Birthday, YYYY-MM-DD. Example: 1985-04-12
- `company_id` (`integer`, optional): Company ID, from moco_companies_list. Example: 760253573
- `firstname` (`string`, optional): First name. Example: Anna
- `gender` (`string`, optional): Unknown values are stored as U. One of: U, M, F. Example: U. One of: `U`, `M`, `F`.
- `info` (`string`, optional): Internal notes. Example: Key account
- `job_position` (`string`, optional): Job title. Example: CTO
- `lastname` (`string`, optional): Last name. Example: Muster
- `mobile_phone` (`string`, optional): Mobile phone. Example: +41 79 123 45 67
- `name` (`string`, optional): Name. Example: Website relaunch
- `salutation` (`string`, optional): Salutation used in letters and documents. Example: Dear Anna
- `tags` (`array`, optional): Tags, comma-separated in queries or an array in bodies. Example: ["Retainer"]
- `title` (`string`, optional): Title. Example: Dr.
- `user_id` (`integer`, optional): User ID, from moco_users_list. Example: 933590696
- `work_address` (`string`, optional): Work address. Example: Hauptstrasse 1, 8000 Zürich
- `work_email` (`string`, optional): Work email. Example: anna@acme.ch
- `work_phone` (`string`, optional): Work phone. Example: +41 44 123 45 67

Example input: `{"contact_id":123456}`

### `moco_deal_create`

Create Deal · Write

Create a deal (lead).
Returns an object with id, name, status, reminder_date, closed_on, money, currency, info, tags, custom_properties, and more.
Use moco_deal_create to add an opportunity.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `closed_on` (`string`, optional): Close date, YYYY-MM-DD. Example: 2026-12-15
- `company_id` (`integer`, optional): Company ID, from moco_companies_list. Example: 760253573
- `currency` (`string`, optional): Currency code. Example: EUR
- `deal_category_id` (`integer`, optional): Deal stage (category) ID, from moco_deal_categories_list. Example: 123
- `info` (`string`, optional): Internal notes. Example: Key account
- `money` (`number`, optional): Expected value. Example: 25000
- `name` (`string`, optional): Deal name. Example: Website relaunch
- `person_id` (`integer`, optional): Contact person ID. Example: 123456
- `reminder_date` (`string`, optional): Follow-up date, YYYY-MM-DD. Example: 2026-12-01
- `service_period_from` (`string`, optional): Service period start, YYYY-MM-DD. Example: 2026-11-01
- `service_period_to` (`string`, optional): Service period end, YYYY-MM-DD. Example: 2026-11-30
- `status` (`string`, optional): Status. One of: potential, pending, won, lost, dropped. Example: pending. One of: `potential`, `pending`, `won`, `lost`, `dropped`.
- `tags` (`array`, optional): Tags, comma-separated in queries or an array in bodies. Example: ["Retainer"]
- `user_id` (`integer`, optional): User ID, from moco_users_list. Example: 933590696

Example input: `{}`

### `moco_deal_update`

Update Deal · Write

Update a deal, for example its status, stage or value.
Returns an object with id, name, status, reminder_date, closed_on, money, currency, info, tags, custom_properties, and more.
Use moco_deal_update to move a deal forward.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `deal_id` (`integer`, required): Deal ID. Example: 123456
- `closed_on` (`string`, optional): Close date, YYYY-MM-DD. Example: 2026-12-15
- `company_id` (`integer`, optional): Company ID, from moco_companies_list. Example: 760253573
- `currency` (`string`, optional): Currency code. Example: EUR
- `deal_category_id` (`integer`, optional): Deal category ID. Required only when status is pending. Example: 12345
- `info` (`string`, optional): Internal notes. Example: Key account
- `money` (`number`, optional): Deal value in selected currency. Example: 10
- `name` (`string`, optional): Name. Example: Website relaunch
- `person_id` (`integer`, optional): Contact person ID. Example: 123456
- `reminder_date` (`string`, optional): Follow-up date, YYYY-MM-DD. Example: 2026-12-01
- `service_period_from` (`string`, optional): Service period start, YYYY-MM-DD. Example: 2026-11-01
- `service_period_to` (`string`, optional): Service period end, YYYY-MM-DD. Example: 2026-11-30
- `status` (`string`, optional): Status. One of: potential, pending, won, lost, dropped. Example: pending. One of: `potential`, `pending`, `won`, `lost`, `dropped`.
- `tags` (`array`, optional): Tags, comma-separated in queries or an array in bodies. Example: ["Retainer"]
- `user_id` (`integer`, optional): User ID, from moco_users_list. Example: 933590696

Example input: `{"deal_id":123456}`

### `moco_invoice_create`

Create Invoice · Write

Create an invoice with items for a customer.
Returns items[] (each with id, type, title, revenue_category, description, quantity, unit, unit_price) plus id, customer_id, project_id, offer_id.
Use moco_invoice_create to bill a customer.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `currency` (`string`, required): Currency code. Example: EUR
- `customer_id` (`integer`, required): Customer company ID. Example: 760253573
- `date` (`string`, required): Date, YYYY-MM-DD. Example: 2026-11-16
- `due_date` (`string`, required): Due date, YYYY-MM-DD. Example: 2026-12-16
- `items` (`array`, required): Invoice items; each has a type (title, description, item, subtotal, page-break, separator) and for type item a title, quantity, unit and unit_price. Example: [{"type": "item", "title": "Design", "quantity": 10, "unit": "h", "unit_price": 150}]
- `recipient_address` (`string`, required): Recipient address block. Example: Acme GmbH
Hauptstrasse 1
8000 Zürich
- `title` (`string`, required): Invoice title. Example: Invoice November 2026
- `contact_id` (`integer`, optional): Contact person ID. Example: 123456
- `discount` (`number`, optional): Discount in percent. Example: 5
- `footer` (`string`, optional): Footer text on the document. Example: Thank you for your business.
- `offer_id` (`integer`, optional): Optional source offer ID. Example: 12345
- `project_id` (`integer`, optional): Project ID, from moco_projects_list. Example: 944504145
- `salutation` (`string`, optional): Salutation used in letters and documents. Example: Dear Anna
- `service_period_from` (`string`, optional): Service period start, YYYY-MM-DD. Example: 2026-11-01
- `service_period_to` (`string`, optional): Service period end, YYYY-MM-DD. Example: 2026-11-30
- `status` (`string`, optional): Initial status. One of: created, draft. Example: draft. One of: `created`, `draft`.
- `tags` (`array`, optional): Tags, comma-separated in queries or an array in bodies. Example: ["Retainer"]

Example input: `{"currency":"<currency>","customer_id":760253573,"date":"<date>","due_date":"<due_date>","items":[{"type":"item","title":"Design","quantity":10,"unit":"h","unit_price":150}],"recipient_address":"<recipient_address>","title":"<title>"}`

### `moco_invoice_payment_create`

Record Invoice Payment · Write

Record a payment on an invoice.
Returns an object with id, date, invoice, paid_total, paid_total_in_account_currency, currency, description, created_at, updated_at.
Use moco_invoice_payment_create when money arrives.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `date` (`string`, required): Payment date, YYYY-MM-DD. Example: 2026-11-16
- `invoice_id` (`integer`, required): Invoice ID. Example: 123456
- `paid_total` (`number`, required): Amount paid. Example: 1500
- `currency` (`string`, optional): Currency code. Example: EUR
- `description` (`string`, optional): Description. Example: UX and visual design
- `partially_paid` (`boolean`, optional): If true, the payment covers only part of the invoice. Example: false

Example input: `{"date":"<date>","invoice_id":123456,"paid_total":1500}`

### `moco_invoice_send`

Send Invoice · Write

Email an invoice to the customer.
Returns an object with emails_to, emails_cc, emails_bcc, subject, text.
Use moco_invoice_send to deliver an invoice. This emails the recipients.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `invoice_id` (`integer`, required): Invoice ID. Example: 123456
- `subject` (`string`, required): Email subject. Example: Invoice November 2026
- `text` (`string`, required): Email text. Example: Dear Anna, please find attached our invoice.
- `emails_bcc` (`string`, optional): BCC recipients as semicolon-separated list. Example: jane@example.com
- `emails_cc` (`string`, optional): CC recipients as semicolon-separated list. Example: jane@example.com
- `emails_to` (`string`, optional): Recipient addresses, separated by semicolons. Example: billing@acme.ch
- `letter_paper_id` (`integer`, optional): Optional letter paper ID used for generated PDF. Example: 12345

Example input: `{"invoice_id":123456,"subject":"<subject>","text":"<text>"}`

### `moco_invoice_status_update`

Update Invoice Status · Write

Change the status of an invoice (for example sent or ignored).
Returns the JSON response from the API.
Use moco_invoice_status_update after sending an invoice outside MOCO.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `invoice_id` (`integer`, required): Invoice ID. Example: 123456
- `status` (`string`, required): Status. One of: created, sent, overdue, ignored. Example: pending. One of: `created`, `sent`, `overdue`, `ignored`.

Example input: `{"invoice_id":123456,"status":"created"}`

### `moco_offer_create`

Create Offer · Write

Create an offer with items.
Returns items[] (each with id, type, title, revenue_category, description, quantity, unit, unit_price) plus id, invoice_id, identifier, date.
Use moco_offer_create for a new quote.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `items` (`array`, required): Offer items; each has a type (title, description, item, subtotal, page-break, separator) and for type item a title, quantity, unit and unit_price. Example: [{"type": "item", "title": "Design", "quantity": 10, "unit": "h", "unit_price": 150}]
- `vat_code_id` (`integer`, required): ID of an active sale VAT code in the account. Example: 12345
- `company_id` (`integer`, optional): Company ID, from moco_companies_list. Example: 760253573
- `contact_id` (`integer`, optional): Contact person ID. Example: 123456
- `currency` (`string`, optional): Currency code. Example: EUR
- `date` (`string`, optional): Date, YYYY-MM-DD. Example: 2026-11-16
- `deal_id` (`integer`, optional): Deal ID, from moco_deals_list. Example: 1234567
- `discount` (`number`, optional): Discount in percent. Example: 5
- `due_date` (`string`, optional): Valid until, YYYY-MM-DD. Example: 2026-12-16
- `footer` (`string`, optional): Footer text on the document. Example: Thank you for your business.
- `identifier` (`string`, optional): Identifier (number); MOCO generates one if empty and numbering is automatic. Example: P2611-001
- `project_id` (`integer`, optional): Project ID, from moco_projects_list. Example: 944504145
- `recipient_address` (`string`, optional): Recipient address block. Example: Acme GmbH
Hauptstrasse 1
8000 Zürich
- `salutation` (`string`, optional): Salutation used in letters and documents. Example: Dear Anna
- `tags` (`array`, optional): Tags, comma-separated in queries or an array in bodies. Example: ["Retainer"]
- `title` (`string`, optional): Offer title. Example: Offer website relaunch

Example input: `{"items":[{"type":"item","title":"Design","quantity":10,"unit":"h","unit_price":150}],"vat_code_id":12345}`

### `moco_offer_status_update`

Update Offer Status · Write

Change the status of an offer (for example sent, accepted).
Returns the JSON response from the API.
Use moco_offer_status_update to record the customer decision.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `offer_id` (`integer`, required): Offer ID. Example: 123456
- `status` (`string`, required): Status. One of: created, sent, accepted, partially_billed, billed, archived. Example: pending. One of: `created`, `sent`, `accepted`, `partially_billed`, `billed`, `archived`.

Example input: `{"offer_id":123456,"status":"created"}`

### `moco_planning_entry_create`

Create Planning Entry · Write

Plan hours per day for a user on a project.
Returns an object with id, title, starts_on, ends_on, hours_per_day, comment, symbol, color, read_only, user, and more.
Use moco_planning_entry_create to book capacity.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `color` (`string`, optional): Colour as a hex code. Example: #3b82f6
- `comment` (`string`, optional): Comment. Example: Workshop week
- `deal_id` (`integer`, optional): Deal ID, from moco_deals_list. Example: 1234567
- `ends_on` (`string`, optional): Last day, YYYY-MM-DD. Example: 2026-11-21
- `hours_per_day` (`number`, optional): Planned hours per day. Example: 4
- `project_id` (`integer`, optional): Project ID, from moco_projects_list. Example: 944504145
- `starts_on` (`string`, optional): First day, YYYY-MM-DD. Example: 2026-11-17
- `task_id` (`integer`, optional): Project task ID, from moco_project_tasks_list. Example: 1234567
- `tentative` (`boolean`, optional): If true, the planning entry is tentative. Example: false
- `title` (`string`, optional): Title. Example: Dr.
- `user_id` (`integer`, optional): User ID, from moco_users_list. Example: 933590696

Example input: `{}`

### `moco_project_archive`

Archive Project · Write

Archive a project.
Returns an object with id, identifier, name, active, billable, fixed_price, retainer, start_date, finish_date, currency, and more.
Use moco_project_archive when a project is finished.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID. Example: 123456

Example input: `{"project_id":123456}`

### `moco_project_create`

Create Project · Write

Create a project for a customer.
Returns an object with id, identifier, name, active, billable, fixed_price, retainer, start_date, finish_date, currency, and more.
Use moco_project_create for new work.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `currency` (`string`, required): Currency code. Example: EUR
- `customer_id` (`integer`, required): Customer company ID. Example: 760253573
- `leader_id` (`integer`, required): Project leader user ID. Example: 933590696
- `name` (`string`, required): Project name. Example: Website relaunch
- `billing_variant` (`string`, optional): How hours are billed. One of: project, task, user. Example: project. One of: `project`, `task`, `user`, `billing_variant_rate_per_project`, `billing_variant_rate_per_task`, `billing_variant_rate_per_user`.
- `budget` (`number`, optional): Budget amount. Example: 20000
- `co_leader_id` (`integer`, optional): Secondary responsible user ID. Example: 12345
- `contact_id` (`integer`, optional): Contact person ID. Example: 123456
- `deal_id` (`integer`, optional): Deal ID, from moco_deals_list. Example: 1234567
- `finish_date` (`string`, optional): End date, YYYY-MM-DD. Example: 2027-03-31
- `fixed_price` (`boolean`, optional): If true, the project has a fixed price. Example: false
- `hourly_rate` (`number`, optional): Hourly rate. Example: 150
- `identifier` (`string`, optional): Identifier (number); MOCO generates one if empty and numbering is automatic. Example: P2611-001
- `info` (`string`, optional): Internal notes. Example: Key account
- `retainer` (`boolean`, optional): Whether project is billed as retainer. Example: true
- `start_date` (`string`, optional): Start date, YYYY-MM-DD. Example: 2026-11-16
- `tags` (`array`, optional): Tags, comma-separated in queries or an array in bodies. Example: ["Retainer"]

Example input: `{"currency":"<currency>","customer_id":760253573,"leader_id":933590696,"name":"<name>"}`

### `moco_project_expense_create`

Create Project Expense · Write

Add an expense (additional service) to a project.
Returns an object with id, date, title, description, quantity, unit, unit_price, unit_cost, price, cost, and more.
Use moco_project_expense_create to bill extra costs.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `project_id` (`integer`, required): Project ID, from moco_projects_list. Example: 944504145
- `billable` (`boolean`, optional): If true, the expense is billable. Example: true
- `budget_relevant` (`boolean`, optional): If true, counts against the project budget. Example: true
- `cost_total_planned` (`number`, optional): Planned internal cost total. Example: 10
- `date` (`string`, optional): Date, YYYY-MM-DD. Example: 2026-11-16
- `description` (`string`, optional): Description. Example: UX and visual design
- `file` (`object`, optional): Optional attachment payload. Example: {"key": "value"}
- `planned_purchase_date` (`string`, optional): Planned purchase date (when planned purchases are enabled). Example: 2026-01-31
- `purchase_assignment_locked` (`boolean`, optional): Locks assignment to purchase items. Example: true
- `quantity` (`number`, optional): Quantity. Example: 1
- `revenue_category_id` (`integer`, optional): Revenue category ID for billing assignment. Rejected with 422 when the revenue category only applies to tasks, unless the stored value is unchanged. Example: 12345
- `service_period_from` (`string`, optional): Service period start, YYYY-MM-DD. Example: 2026-11-01
- `service_period_to` (`string`, optional): Service period end, YYYY-MM-DD. Example: 2026-11-30
- `title` (`string`, optional): Expense title. Example: Hosting
- `unit` (`string`, optional): Unit. Example: month
- `unit_cost` (`number`, optional): Cost per unit. Example: 30
- `unit_price` (`number`, optional): Price per unit. Example: 50
- `user_id` (`integer`, optional): User ID, from moco_users_list. Example: 933590696

Example input: `{"project_id":944504145}`

### `moco_project_task_create`

Create Project Task · Write

Add a task to a project.
Returns an object with id, name, description, billable, active, budget, hourly_rate, revenue_category, created_at, updated_at.
Use moco_project_task_create to add a billable service to a project.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `project_id` (`integer`, required): Project ID, from moco_projects_list. Example: 944504145
- `active` (`boolean`, optional): Filter or set the active flag. Example: true
- `billable` (`boolean`, optional): If true, time on the task is billable. Example: true
- `budget` (`number`, optional): Budget. Example: 5000
- `description` (`string`, optional): Description. Example: UX and visual design
- `hourly_rate` (`number`, optional): Hourly rate. Example: 140
- `name` (`string`, optional): Task name. Example: Design

Example input: `{"project_id":944504145}`

### `moco_project_task_update`

Update Project Task · Write

Update a project task.
Returns an object with id, name, description, billable, active, budget, hourly_rate, revenue_category, created_at, updated_at.
Use moco_project_task_update to change a task rate, budget or status.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID, from moco_projects_list. Example: 944504145
- `task_id` (`integer`, required): Task ID. Example: 123456
- `active` (`boolean`, optional): Filter or set the active flag. Example: true
- `billable` (`boolean`, optional): Billable flag. Example: true
- `budget` (`number`, optional): Budget amount. Example: 5000
- `description` (`string`, optional): Description. Example: UX and visual design
- `hourly_rate` (`number`, optional): Hourly rate. Example: 140
- `name` (`string`, optional): Name. Example: Website relaunch

Example input: `{"project_id":944504145,"task_id":123456}`

### `moco_project_update`

Update Project · Write

Update a project.
Returns an object with id, identifier, name, active, billable, fixed_price, retainer, start_date, finish_date, currency, and more.
Use moco_project_update to change budget, dates or leader.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID. Example: 123456
- `billing_variant` (`string`, optional): Pricing mode for hourly rates. Preferred values are project, task, user. billing_variant_rate_per_project, billing_variant_rate_per_task, billing_variant_rate_per_user are also accepted. One of: project, task, user, billing_variant_rate_per_project, billing_variant_rate_per_task, billing_variant_rate_per_user. Example: project. One of: `project`, `task`, `user`, `billing_variant_rate_per_project`, `billing_variant_rate_per_task`, `billing_variant_rate_per_user`.
- `budget` (`number`, optional): Budget amount. Example: 5000
- `co_leader_id` (`integer`, optional): Secondary responsible user ID. Example: 12345
- `contact_id` (`integer`, optional): Contact person ID. Example: 123456
- `finish_date` (`string`, optional): Project finish date. Example: 2026-01-31
- `fixed_price` (`boolean`, optional): Whether the project is fixed price. Example: true
- `hourly_rate` (`number`, optional): Hourly rate. Example: 140
- `identifier` (`string`, optional): Identifier (number); MOCO generates one if empty and numbering is automatic. Example: P2611-001
- `info` (`string`, optional): Internal notes. Example: Key account
- `leader_id` (`integer`, optional): Main responsible user ID. Example: 12345
- `name` (`string`, optional): Name. Example: Website relaunch
- `start_date` (`string`, optional): Project start date. Example: 2026-01-31
- `tags` (`array`, optional): Tags, comma-separated in queries or an array in bodies. Example: ["Retainer"]

Example input: `{"project_id":123456}`

### `moco_activity_delete`

Delete Activity · Destructive

Delete a time entry.
Returns an object with id, date, hours, description, billed, billable, invoice_id, tag, remote_service, remote_id, and more.
Use moco_activity_delete to remove a wrong entry.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `activity_id` (`integer`, required): Activity ID. Example: 123456

Example input: `{"activity_id":123456}`

## Related

Other Project Management connectors ([all 67](/agentkit/connectors/?category=project-management)):

- [Notion](/agentkit/connectors/notion/): Scalekit connector, OAuth, 51 tools
- [Linear](/agentkit/connectors/linear/): Scalekit connector, OAuth, 64 tools
- [Airtable](/agentkit/connectors/airtable/): Scalekit connector, OAuth, 26 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
