Harvest create invoice

harvest__create_invoice

Access

Requires a project integration connection for harvest.

Call type: Can change resources.

Arguments

FieldTypeRequiredDescription and constraints
account_idstringYesHarvest Account ID (get it from harvest__list_accounts)
client_idnumberYesClient ID to invoice
subjectstringNoInvoice subject line
notesstringNoInvoice notes visible to client
issue_datestringNoIssue date (YYYY-MM-DD, defaults to today)
due_datestringNoDue date (YYYY-MM-DD)
currencystringNoInvoice currency code (e.g. USD, EUR). Defaults to account currency.
line_items_importobjectNoImport time entries/expenses into line items: { project_ids: number[], time: { summary_type, from, to }, expenses: { summary_type, from, to, attach_receipt } }
line_itemsvalue[]NoManual line items array: [{ kind, description, unit_price, quantity, taxed, taxed2 }]

Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "harvest__create_invoice",
    "arguments": {
      "account_id": "example",
      "client_id": 0
    }
  }
}

Result

No output schema is published for this tool. The input contract does not define its return fields. Inspect the MCP response content and isError; do not assume a fixed object shape. See the harvest integration reference for provider setup and tool context.

Full schemas

json
{
  "type": "object",
  "properties": {
    "account_id": {
      "type": "string",
      "description": "Harvest Account ID (get it from harvest__list_accounts)"
    },
    "client_id": {
      "type": "number",
      "description": "Client ID to invoice"
    },
    "subject": {
      "type": "string",
      "description": "Invoice subject line"
    },
    "notes": {
      "type": "string",
      "description": "Invoice notes visible to client"
    },
    "issue_date": {
      "type": "string",
      "description": "Issue date (YYYY-MM-DD, defaults to today)"
    },
    "due_date": {
      "type": "string",
      "description": "Due date (YYYY-MM-DD)"
    },
    "currency": {
      "type": "string",
      "description": "Invoice currency code (e.g. USD, EUR). Defaults to account currency."
    },
    "line_items_import": {
      "type": "object",
      "description": "Import time entries/expenses into line items: { project_ids: number[], time: { summary_type, from, to }, expenses: { summary_type, from, to, attach_receipt } }"
    },
    "line_items": {
      "type": "array",
      "description": "Manual line items array: [{ kind, description, unit_price, quantity, taxed, taxed2 }]"
    }
  },
  "required": [
    "account_id",
    "client_id"
  ],
  "description": "Arguments for the harvest__create_invoice tool."
}