# NeetoInvoice Docs

> Developer docs for NeetoInvoice: the REST API, the CLI and the MCP server.

- [NeetoInvoice API](https://apidocs.neetoinvoice.com/api/introduction.md): Welcome to the NeetoInvoice API documentation.
- [Workspace subdomain](https://apidocs.neetoinvoice.com/api/workspace-subdomain.md): Learn how to find your workspace subdomain.
- [Authentication](https://apidocs.neetoinvoice.com/api/authentication.md): Learn how to authenticate your requests to the NeetoInvoice API using API keys.
- [Pagination](https://apidocs.neetoinvoice.com/api/pagination.md): Learn how to handle paginated responses in the NeetoInvoice API.
- [HTTP response codes](https://apidocs.neetoinvoice.com/api/response-codes.md): Learn about the HTTP status codes returned by the NeetoInvoice API.
- [Getting the user ID](https://apidocs.neetoinvoice.com/api/getting-user-id.md): Understand how to retrieve user IDs for use in your API calls.
- [Getting the client ID](https://apidocs.neetoinvoice.com/api/getting-client-id.md): Understand how to retrieve client IDs for use in your API calls.
- [Getting the project ID](https://apidocs.neetoinvoice.com/api/getting-project-id.md): Understand how to retrieve project IDs for use in your API calls.
- [Getting the task ID](https://apidocs.neetoinvoice.com/api/getting-task-id.md): Understand how to retrieve task IDs for use in your API calls.
- [Getting the time entry ID](https://apidocs.neetoinvoice.com/api/getting-time-entry-id.md): Understand how to retrieve time entry IDs for use in your API calls.
- [Getting the checklist ID](https://apidocs.neetoinvoice.com/api/getting-checklist-id.md): Understand how to retrieve checklist IDs for use in your API calls.
- [Getting the recipient ID](https://apidocs.neetoinvoice.com/api/getting-recipient-id.md): Understand how to retrieve recipient IDs for use in your API calls.
- [Getting the project user ID](https://apidocs.neetoinvoice.com/api/getting-project-user-id.md): Understand how to retrieve project user IDs for use in your API calls.
- [List clients](https://apidocs.neetoinvoice.com/api/clients/list.md): List the workspace's clients ordered by name. Without `page` or `page_size`, the response holds every record on one page. When you send either one, the list is paginated: 30 per page by default and up to 100.
- [Create client](https://apidocs.neetoinvoice.com/api/clients/create.md): Create a client.
- [Get client](https://apidocs.neetoinvoice.com/api/clients/get.md): Get a client.
- [Update client](https://apidocs.neetoinvoice.com/api/clients/update.md): Update a client. Can also be used to update client status by passing `status` in the request body.
- [Create recipient](https://apidocs.neetoinvoice.com/api/recipients/create.md): Create a recipient.
- [Update recipient](https://apidocs.neetoinvoice.com/api/recipients/update.md): Update a recipient.
- [Delete recipient](https://apidocs.neetoinvoice.com/api/recipients/delete.md): Delete a recipient.
- [List projects](https://apidocs.neetoinvoice.com/api/projects/list.md): List the workspace's projects ordered by name. Without `page` or `page_size`, the response holds every record on one page. When you send either one, the list is paginated: 30 per page by default and up to 100.
- [Create project](https://apidocs.neetoinvoice.com/api/projects/create.md): Create a project.
- [Get project](https://apidocs.neetoinvoice.com/api/projects/get.md): Get a project.
- [Update project](https://apidocs.neetoinvoice.com/api/projects/update.md): Update a project.
- [List project users](https://apidocs.neetoinvoice.com/api/project-users/list.md): List the users assigned to a project. Without `page` or `page_size`, the response holds every record on one page. When you send either one, the list is paginated: 30 per page by default and up to 100.
- [Add project user](https://apidocs.neetoinvoice.com/api/project-users/add.md): Add a user to a project. Identify the user with `project_user.user_id` or `project_user.user_email`.
- [Update project user](https://apidocs.neetoinvoice.com/api/project-users/update.md): Update a project user.
- [Remove project user](https://apidocs.neetoinvoice.com/api/project-users/remove.md): Remove a user from a project.
- [List team members](https://apidocs.neetoinvoice.com/api/team-members/list.md): List all team members.
- [Add team members](https://apidocs.neetoinvoice.com/api/team-members/add.md): Add team members.
- [Update team member](https://apidocs.neetoinvoice.com/api/team-members/update.md): Update a team member.
- [Remove team members](https://apidocs.neetoinvoice.com/api/team-members/remove.md): Remove team members.
- [Create time entry](https://apidocs.neetoinvoice.com/api/time-entry/create.md): Create a time entry.
- [List time entries](https://apidocs.neetoinvoice.com/api/time-entry/list.md): List unbilled time entries for a project. Only time entries not associated with billed invoices are returned.
- [List invoices](https://apidocs.neetoinvoice.com/api/invoices/list.md): List the workspace's invoices, newest issue date first, 30 per page by default and up to 100. Deleted invoices are left out.
- [Generate invoice](https://apidocs.neetoinvoice.com/api/invoices/create.md): Generate an invoice for a client from unbilled time entries, services, expenses or fixed price projects, with optional taxes. The invoice is generated in the background, so its status is `generating` when the request returns.
- [Send an invoice](https://apidocs.neetoinvoice.com/api/invoices/send.md): Email a generated invoice to the client's recipients and mark it as sent. Without `recipient_ids`, every current recipient of the client receives it.
- [List monthly PTO](https://apidocs.neetoinvoice.com/api/monthly-ptos/list.md): List what each user earned and used in a month. Every PTO value is in hours. The full set is returned, ordered by name.
- [Update PTO earned](https://apidocs.neetoinvoice.com/api/monthly-ptos/update-earned.md): Set the PTO earned for a month for one or more users. The value is in hours. Emails are matched case-insensitively and duplicates are ignored. An email that matches no active user is listed under `skipped`. A user whose PTO for that month is locked is also skipped and listed under `skipped` with the…
- [Payroll summary](https://apidocs.neetoinvoice.com/api/reports/payroll-summary.md): Per user, the working days (Mon-Fri) in a month, the days with time logged and the loss-of-pay (LOP) days. A working day with nothing logged is an LOP day. The full set is returned, ordered by name.
- [List missing timesheet days](https://apidocs.neetoinvoice.com/api/reports/missing-entries.md): List the working days (Mon-Fri) in a date range with nothing logged. Time logged to a PTO or holiday task counts as logged, and a holiday with nothing logged counts as missing. Pass `email` for one user, or leave it out to cover every active team member; the team-wide report lists only users with at…
- [Timesheet summary](https://apidocs.neetoinvoice.com/api/reports/timesheet-summary.md): Hours logged in a date range, per user and per day with each entry. The full set is returned, ordered by name.
- [Create client](https://apidocs.neetoinvoice.com/api-reference-v1/clients/create.md): Create a client.
- [Get client](https://apidocs.neetoinvoice.com/api-reference-v1/clients/get.md): Get a client.
- [Update client](https://apidocs.neetoinvoice.com/api-reference-v1/clients/update.md): Update a client.
- [Update client status](https://apidocs.neetoinvoice.com/api-reference-v1/clients/update-status.md): Update client status.
- [Create recipient](https://apidocs.neetoinvoice.com/api-reference-v1/recipients/create.md): Create a recipient.
- [Update recipient](https://apidocs.neetoinvoice.com/api-reference-v1/recipients/update.md): Update a recipient.
- [Delete recipient](https://apidocs.neetoinvoice.com/api-reference-v1/recipients/delete.md): Delete a recipient.
- [Create project](https://apidocs.neetoinvoice.com/api-reference-v1/projects/create.md): Create a project.
- [Get project](https://apidocs.neetoinvoice.com/api-reference-v1/projects/get.md): Get a project.
- [Update project](https://apidocs.neetoinvoice.com/api-reference-v1/projects/update.md): Update a project.
- [Update project status](https://apidocs.neetoinvoice.com/api-reference-v1/projects/update-status.md): Update project status.
- [List project users](https://apidocs.neetoinvoice.com/api-reference-v1/project-users/list.md): List all users assigned to a project.
- [Add project user](https://apidocs.neetoinvoice.com/api-reference-v1/project-users/add.md): Add a user to a project.
- [Update project user](https://apidocs.neetoinvoice.com/api-reference-v1/project-users/update.md): Update a project user.
- [Remove project user](https://apidocs.neetoinvoice.com/api-reference-v1/project-users/remove.md): Remove a user from a project.
- [List team members](https://apidocs.neetoinvoice.com/api-reference-v1/team-members/list.md): List all team members.
- [Add team members](https://apidocs.neetoinvoice.com/api-reference-v1/team-members/add.md): Add team members.
- [Update team member](https://apidocs.neetoinvoice.com/api-reference-v1/team-members/update.md): Update a team member.
- [Remove team members](https://apidocs.neetoinvoice.com/api-reference-v1/team-members/remove.md): Remove team members.
- [Create time entry](https://apidocs.neetoinvoice.com/api-reference-v1/time-entry/create.md): Create a time entry.
- [List time entries](https://apidocs.neetoinvoice.com/api-reference-v1/time-entry/list.md): List unbilled time entries for a project. Only time entries not associated with billed invoices are returned.
- [Generate invoice](https://apidocs.neetoinvoice.com/api-reference-v1/invoices/create.md): Generate an invoice for a client.
- [NeetoInvoice CLI](https://apidocs.neetoinvoice.com/cli/introduction.md): Manage clients, projects, time entries, invoices, and more from your terminal.
- [Installation](https://apidocs.neetoinvoice.com/cli/installation.md): Install the neetoinvoice CLI on macOS, Linux, or Windows.
- [Workspace subdomain](https://apidocs.neetoinvoice.com/cli/workspace-subdomain.md): Find your workspace subdomain and tell the CLI which workspace to use.
- [Authentication](https://apidocs.neetoinvoice.com/cli/authentication.md): Sign in through the browser and manage credentials for one or more workspaces.
- [Output formats](https://apidocs.neetoinvoice.com/cli/output-formats.md): Pretty tables, JSON, quiet, and TOON - and when to use each.
- [AI assistants](https://apidocs.neetoinvoice.com/cli/ai-assistants.md): Set up NeetoInvoice for Claude, Cursor, Copilot, and other AI coding assistants.
- [Troubleshooting](https://apidocs.neetoinvoice.com/cli/troubleshooting.md): Diagnose authentication and connectivity issues with neetoinvoice doctor.
- [Commands overview](https://apidocs.neetoinvoice.com/cli-reference/overview.md): Every neetoinvoice command grouped by resource, with links to the full reference.
- [Clients](https://apidocs.neetoinvoice.com/cli-reference/clients.md): List, view, create, and update clients.
- [Recipients](https://apidocs.neetoinvoice.com/cli-reference/recipients.md): Create, update, and delete the people who receive a client's invoices.
- [Projects](https://apidocs.neetoinvoice.com/cli-reference/projects.md): List, view, create, and update client projects.
- [Project users](https://apidocs.neetoinvoice.com/cli-reference/project-users.md): List, create, update, and delete the users assigned to a project.
- [Team members](https://apidocs.neetoinvoice.com/cli-reference/team-members.md): List, view, add, update, and remove team members.
- [Time entries](https://apidocs.neetoinvoice.com/cli-reference/time-entries.md): List, create, update, and delete time entries on a project.
- [Invoices](https://apidocs.neetoinvoice.com/cli-reference/invoices.md): List, generate, and send invoices.
- [Monthly PTO](https://apidocs.neetoinvoice.com/cli-reference/monthly-ptos.md): List the monthly PTO report and update PTO earned.
- [Reports](https://apidocs.neetoinvoice.com/cli-reference/reports.md): Show payroll summaries, timesheet summaries, and missing timesheet entries.
- [Utility commands](https://apidocs.neetoinvoice.com/cli-reference/utility.md): Authentication, diagnostics, versioning, upgrades, AI-assistant setup, and shell completion.
- [NeetoInvoice MCP](https://apidocs.neetoinvoice.com/mcp/introduction.md): Manage your NeetoInvoice billing and time tracking from an AI assistant in plain language.
- [Workspace subdomain](https://apidocs.neetoinvoice.com/mcp/workspace-subdomain.md): Find your workspace subdomain and use it to connect an assistant.
- [Authentication](https://apidocs.neetoinvoice.com/mcp/authentication.md): Connect as yourself with OAuth, or as the whole workspace with an API key.
- [MCP server](https://apidocs.neetoinvoice.com/mcp/server.md): The NeetoInvoice MCP server endpoint, transport, and the sign-in options each agent supports.
- [Connect agent](https://apidocs.neetoinvoice.com/mcp/connect.md): Step-by-step setup for Claude, ChatGPT, and other AI agents.
- [Examples](https://apidocs.neetoinvoice.com/mcp/examples.md): Prompts to try once your assistant is connected to NeetoInvoice.
- [Troubleshooting](https://apidocs.neetoinvoice.com/mcp/troubleshooting.md): What to check when an assistant cannot reach NeetoInvoice.
- [Tools](https://apidocs.neetoinvoice.com/mcp/tools.md): Every tool the NeetoInvoice MCP server exposes, grouped by resource.

## OpenAPI Specs

- [clients](/bundled-v1/clients.yaml)
- [invoices](/bundled-v1/invoices.yaml)
- [project-users](/bundled-v1/project-users.yaml)
- [projects](/bundled-v1/projects.yaml)
- [recipients](/bundled-v1/recipients.yaml)
- [team-members](/bundled-v1/team-members.yaml)
- [time-entry](/bundled-v1/time-entry.yaml)
- [clients](/bundled/clients.yaml)
- [invoices](/bundled/invoices.yaml)
- [monthly-ptos](/bundled/monthly-ptos.yaml)
- [project-users](/bundled/project-users.yaml)
- [projects](/bundled/projects.yaml)
- [recipients](/bundled/recipients.yaml)
- [reports](/bundled/reports.yaml)
- [team-members](/bundled/team-members.yaml)
- [time-entry](/bundled/time-entry.yaml)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.