# Zoho Invoice — how to use (mcp.ai)

Zoho Invoice simplifies billing, recurring payments, and expense management, helping freelancers and small businesses send professional invoices

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_zoho_invoice?ms=1781542980000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `zoho_invoice_get_item`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/zoho_invoice`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/zoho_invoice/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/zoho_invoice/get/item` — Tool to retrieve the details of a specific item by item id. use when you need to fetch an item's data after confirming its existence.
  - body: { item_id: string, organization_id: string }
- `POST https://api.mcp.ai/api/zoho_invoice/list/contacts` — Tool to list contacts. use after obtaining the organization id to retrieve contacts with optional filters and pagination.
  - body: { page?: integer, email?: string, phone?: string, address?: string, per_page?: integer, filter_by?: string, last_name?: string, first_name?: string, search_text?: string, sort_column?: string, company_name?: string, contact_name?: string, email_contains?: string, phone_contains?: string, organization_id: string, zcrm_account_id?: string, zcrm_contact_id?: string, address_contains?: string, email_startswith?: string, phone_startswith?: string, address_startswith?: string, last_name_contains?: string, first_name_contains?: string, last_name_startswith?: string, company_name_contains?: string, contact_name_contains?: string, first_name_startswith?: string, company_name_startswith?: string, contact_name_startswith?: string }
- `POST https://api.mcp.ai/api/zoho_invoice/list/expenses` — Tool to list all expenses with optional pagination. use when you need to retrieve expenses with simple pagination.
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/zoho_invoice/list/invoices` — Tool to list invoices. use when you need to retrieve all invoices with optional filters and pagination.
  - body: { date?: string, page?: integer, email?: string, total?: number, status?: string, balance?: number, item_id?: string, date_end?: string, due_date?: string, per_page?: integer, filter_by?: string, item_name?: string, date_after?: string, date_start?: string, customer_id?: string, date_before?: string, search_text?: string, sort_column?: string, custom_field?: string, due_date_end?: string, customer_name?: string, due_date_after?: string, due_date_start?: string, invoice_number?: string, due_date_before?: string, item_description?: string, reference_number?: string, zcrm_potential_id?: string, item_name_contains?: string, item_name_startswith?: string, recurring_invoice_id?: string, custom_field_contains?: string, custom_field_startswith?: string, item_description_contains?: string, item_description_startswith?: string }
- `POST https://api.mcp.ai/api/zoho_invoice/list/items` — Tool to list all items. use when you need to retrieve your item catalog with optional pagination and filtering after specifying the organization id.
  - body: { page?: integer, per_page?: integer, filter_by?: string, search_text?: string, organization_id: string }
- `POST https://api.mcp.ai/api/zoho_invoice/list/payments` — Tool to list payments. use when you need to retrieve all payments with optional filters like customer, invoice, date range, and pagination.
  - body: { mode?: string, page?: integer, date_end?: string, per_page?: integer, filter_by?: string, date_start?: string, invoice_id?: string, sort_order?: string, customer_id?: string, sort_column?: string, payment_number?: string, reference_number?: string }

## More
- Page: https://mcp.ai/zoho_invoice
- Agent spec (llms.txt): https://mcp.ai/zoho_invoice/llms.txt
- Postman collection: https://mcp.ai/zoho_invoice/postman.json