Harvest - Atako

Let your agents log and review time, manage clients and projects, and draft invoices and reports in your Harvest account.

Connection

Authentication: OAuth 2.0 (you authorize Atako via Harvest’s consent screen; no key to copy) — or a Personal access token you paste in directly, if you prefer not to use OAuth.
Required settings:
- Account ID — Numeric ID, e.g. 1234567 — in the URL of https://id.getharvest.com/accounts, or shown next to your personal access token (Settings → My profile → Developers).

Go to https://id.getharvest.com/developers → Create new personal access token → name it and copy the token. The Account ID is shown on the same page, next to the token: paste it in the Account ID field.See Harvest’s documentation.

Read actions (12)

Action	Description
`get_current_user`	Get the authenticated user (id, name, email, roles, timezone). Also verifies the credential.
`get_invoice`	Get one invoice with its line items, amounts and state.
`get_project`	Get one project (client, billing and budget settings, dates).
`list_clients`	List clients, optionally only active (is_active=true) or archived ones. Paginate with links.next → cursor.
`list_invoices`	List invoices, filtered by client_id, project_id, state (draft\|open\|paid\|closed), from/to (issue date, YYYY-MM-DD). Paginate with links.next → cursor.
`list_project_task_assignments`	List the tasks assigned to a project — the valid task_id values for time entries on that project.
`list_projects`	List projects, optionally filtered by client_id and is_active. Paginate with links.next → cursor.
`list_tasks`	List the account task types (Design, Development…). Paginate with links.next → cursor.
`list_time_entries`	List time entries, filtered by user_id, client_id, project_id, task_id, is_billed, is_running, approval_status, from/to (spent date, YYYY-MM-DD). per_page up to 2000. Paginate with links.next → cursor.
`list_users`	List users of the account (Administrator, or Manager with assigned teammates, only). Paginate with links.next → cursor.
`time_report`	Time report totals (hours, billable hours and amounts) between from and to (required), grouped by clients, projects, tasks or team. include_forecast applies to projects/team only.
`uninvoiced_report`	Uninvoiced hours, expenses and amounts per project between from and to (required, at most 365 days apart).

Write actions (6)

Action	Description
`create_client`	Create a client: name (required), address (free text, line breaks allowed), currency (ISO code, defaults to the account currency), is_active.
`create_invoice`	Create a free-form draft invoice for client_id with line_items [{kind (e.g. “Service”), description, quantity, unit_price, project_id, taxed, taxed2}]. Optional: subject, notes, number, purchase_order, currency, issue_date, due_date, payment_term, tax, tax2, discount (percentages). Does not send it.
`create_project`	Create a project for a client. Required: client_id, name, is_billable, bill_by (Project\|Tasks\|People\|none), budget_by (project\|project_cost\|task\|task_fees\|person\|none). Optional: code, hourly_rate, budget (hours), cost_budget, is_fixed_fee, fee, notes, starts_on, ends_on.
`create_time_entry`	Log time: project_id, task_id, spent_date (YYYY-MM-DD) required. Duration accounts: hours (omit it to start a running timer). Start/end accounts: started_time/ended_time like “8:00am”. user_id defaults to the authenticated user.
`set_timer`	Stop a running timer (operation “stop”) or restart a stopped time entry (operation “restart”).
`update_time_entry`	Update a time entry: project_id, task_id, spent_date, hours, started_time, ended_time, notes — only the fields given change.

Permissions

Every action above must be explicitly granted to an agent before it can be used. See Permissions for the grant model and Security for how credentials are protected.

Last reviewed against the provider API: September 2026.