Harvest list invoices

harvest__list_invoices

Access

Requires a project integration connection for harvest.

Call type: Can read or manage credentials.

Arguments

FieldTypeRequiredDescription and constraints
account_idstringYesHarvest Account ID (get it from harvest__list_accounts)
client_idnumberNoFilter by client ID
project_idnumberNoFilter by project ID
statestringNoFilter by state: draft, open, paid, closed
fromstringNoOnly invoices with issue_date >= from (YYYY-MM-DD)
tostringNoOnly invoices with issue_date <= to (YYYY-MM-DD)
updated_sincestringNoOnly return invoices updated after this ISO 8601 datetime
pagenumberNoPage number
per_pagenumberNoResults per page (max 100)

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__list_invoices",
    "arguments": {
      "account_id": "example"
    }
  }
}

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": "Filter by client ID"
    },
    "project_id": {
      "type": "number",
      "description": "Filter by project ID"
    },
    "state": {
      "type": "string",
      "description": "Filter by state: draft, open, paid, closed"
    },
    "from": {
      "type": "string",
      "description": "Only invoices with issue_date >= from (YYYY-MM-DD)"
    },
    "to": {
      "type": "string",
      "description": "Only invoices with issue_date <= to (YYYY-MM-DD)"
    },
    "updated_since": {
      "type": "string",
      "description": "Only return invoices updated after this ISO 8601 datetime"
    },
    "page": {
      "type": "number",
      "description": "Page number"
    },
    "per_page": {
      "type": "number",
      "description": "Results per page (max 100)"
    }
  },
  "required": [
    "account_id"
  ],
  "description": "Arguments for the harvest__list_invoices tool."
}