Can I use Harvest as a CLI?

Yes. KosmoKrator exposes a Harvest CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Harvest through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Harvest tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Harvest credentials stored?

Harvest credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Harvest MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Harvest MCP, CLI, and Lua Integration for AI Agents

Harvest integration docs for AI agents: MCP gateway setup, Harvest CLI commands, Lua API reference, credentials, and function schemas.

12 functions 9 read 3 write Manual OAuth token auth

Submit Harvest feedback View package source

Harvest for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: harvest
route_slug: harvest
package: harvest
auth_strategy: oauth2_manual_token Manual OAuth token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. Harvest CLIHeadless setup and direct function calls. Harvest MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Harvest MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Harvest.

Claude Code Harvest MCP setup for Claude Code. Cursor Harvest MCP setup for Cursor. Codex Harvest MCP setup for Codex. OpenAI Agents Harvest MCP setup for OpenAI Agents SDK. Claude Agent SDK Harvest MCP setup for Claude Agent SDK. Vercel AI SDK Harvest MCP setup for Vercel AI SDK. LangChain Harvest MCP setup for LangChain. LangGraph Harvest MCP setup for LangGraph. CrewAI Harvest MCP setup for CrewAI. MCP clients Harvest MCP setup for Generic MCP Clients.

Harvest CLI Matrix

Use these pages for direct Harvest CLI workflows in scripts, CI, cron, and agent wrappers.

CI Harvest CLI for CI. Cron Jobs Harvest CLI for cron jobs. Shell Scripts Harvest CLI for shell scripts. Headless Automation Harvest CLI for headless automation. Coding Agents Harvest CLI for coding agents.

Function Catalog

Function	Type	Parameters	Description
`harvest.harvest_list_time_entries`	Read `read`	9	List Harvest time entries with optional filters for user, client, project, and date range.
`harvest.harvest_create_time_entry`	Write `write`	6	Create a new Harvest time entry for a project and task.
`harvest.harvest_get_time_entry`	Read `read`	1	Get a single Harvest time entry by its ID.
`harvest.harvest_update_time_entry`	Write `write`	4	Update an existing Harvest time entry (hours, notes, or spent_date).
`harvest.harvest_delete_time_entry`	Write `write`	1	Delete a Harvest time entry by its ID.
`harvest.harvest_list_projects`	Read `read`	4	List Harvest projects with optional filters for client and active status.
`harvest.harvest_get_project`	Read `read`	1	Get a single Harvest project by its ID.
`harvest.harvest_list_clients`	Read `read`	2	List Harvest clients with optional active status filter.
`harvest.harvest_list_tasks`	Read `read`	2	List Harvest tasks with optional active status filter.
`harvest.harvest_list_users`	Read `read`	3	List Harvest users with optional active status filter.
`harvest.harvest_get_user`	Read `read`	1	Get a single Harvest user by their ID.
`harvest.harvest_get_current_user`	Read `read`	0	Get the currently authenticated Harvest user profile.