harvest-mcp-server

Retrieve company information and settings for the authenticated account. Returns comprehensive company details including billing configuration, time tracking preferences, and enabled features.

Retrieve a list of time entries with optional filtering. Supports filtering by user, client, project, task, billing status, date ranges, and more. Returns paginated results.

Retrieve a specific time entry by its ID. Returns complete time entry details including project, task, user, and timing information.

Create a new time entry. Requires project_id, task_id, and spent_date. Must provide either hours OR both started_time and ended_time.

Update an existing time entry. Can modify project, task, hours, notes, and other fields. Only provided fields will be updated.

Delete a time entry permanently. This action cannot be undone.

Start a timer for a new time entry. Creates a running time entry that tracks time automatically.

Stop a running timer and finalize the time entry with calculated hours.

Restart a previously stopped timer, creating a new running time entry based on an existing entry.

Retrieve a list of projects with optional filtering by client, active status, and updated date. Returns paginated results with comprehensive project details.

Retrieve a specific project by its ID. Returns complete project details including client information, budget settings, billing configuration, and project dates.

Create a new project for a client. Requires project name and client ID. Supports extensive configuration including budget settings, billing preferences, and project timeline.

Update an existing project. Can modify any project settings including name, billing configuration, budget settings, and project timeline. Only provided fields will be updated.

Delete (archive) a project. This action archives the project rather than permanently deleting it, preserving historical data while making it inactive.

Retrieve task assignments for a specific project. Shows which tasks are available for time tracking on the project and their specific settings.

Assign a task to a project, making it available for time tracking on that project. Allows setting project-specific rates and budgets.

Update an existing project task assignment including rates, budget, and active status. Only provided fields will be updated.

Remove a task assignment from a project, making the task unavailable for time tracking on that project.

Retrieve a list of tasks with optional filtering. Tasks are the building blocks for time tracking and can be assigned to projects.

Retrieve a specific task by its ID. Returns complete task details including default billing settings and activity status.

Create a new task that can be assigned to projects for time tracking. Tasks define what type of work is being performed.

Update an existing task. Can modify task name, billing settings, and activity status. Only provided fields will be updated.

Delete (archive) a task. This action archives the task rather than permanently deleting it, preserving historical data while making it inactive.

Retrieve a list of clients with optional filtering by active status and updated date. Returns paginated results with client details including billing information.

Retrieve a specific client by its ID. Returns complete client details including contact information and billing configuration.

Create a new client for project management and billing. Requires client name and supports address and currency configuration.

Update an existing client. Can modify name, active status, address, and currency. Only provided fields will be updated.

Delete (archive) a client. This action archives the client rather than permanently deleting it, preserving historical project and billing data.

Retrieve a list of users with optional filtering by active status and updated date. Returns paginated results with user profiles and permissions.

Retrieve a specific user by ID. Returns complete user profile including roles, permissions, and billing rates.

Retrieve the currently authenticated user's profile and permissions.

Create a new user with specified roles and permissions. Supports team member management and access control.

Update an existing user's profile, permissions, and rates. Only provided fields will be updated.

Delete (archive) a user. This action archives the user rather than permanently deleting them, preserving time tracking history.

Retrieve invoices with optional filtering by client, project, state, and date ranges. Returns paginated results with complete invoice details.

Retrieve a specific invoice by ID with complete details including line items, payments, and billing information.

Create a new invoice for a client with optional line items and billing details. Supports custom terms, taxes, and payment configurations.

Update an existing invoice including subject, dates, terms, taxes, and other billing details. Only provided fields will be updated.

Delete an invoice permanently. This action cannot be undone and will remove all associated billing data.

Retrieve expenses with filtering by user, client, project, billing status, and date ranges. Returns paginated results with expense details.

Retrieve a specific expense by ID with complete details including receipts and billing information.

Create a new expense entry for a project with category and cost details. Supports receipt attachment and billable status.

Update an existing expense including project, category, cost, and billing details. Only provided fields will be updated.

Delete an expense permanently. This action cannot be undone.

Retrieve available expense categories for expense classification and organization.

Retrieve estimates with filtering by client, state, and date ranges. Returns paginated results with estimate details.

Retrieve a specific estimate by ID with complete details including line items, terms, and client information.

Create a new estimate for a client with optional line items and terms. Supports custom pricing, taxes, and discounts.

Update an existing estimate including subject, terms, taxes, and other details. Only provided fields will be updated.

Delete an estimate permanently. This action cannot be undone.

Generate comprehensive time tracking reports with filtering by date range, users, clients, projects, and tasks. Supports grouping and billable status filtering.

Generate comprehensive expense reports with filtering by date range, users, clients, projects, and categories. Supports grouping and billing status filtering.

Generate project budget reports showing spending vs budgets across projects. Helps track project profitability and budget utilization.

Generate reports of uninvoiced time and expenses within a date range. Essential for identifying billable work that hasn't been invoiced yet.