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 Gateway for AI Agents

Expose Harvest tools to Claude Code, Cursor, Codex, and other MCP clients through the local KosmoKrator MCP gateway.

12 functions 9 read 3 write Manual OAuth token auth

Submit Harvest feedback View package source

Harvest MCP Gateway

Expose Harvest to MCP clients with `kosmokrator mcp:serve --integration=harvest`.

If the client has never used KosmoKrator before, install it first, then register this integration as a stdio MCP server. The gateway exposes only the selected integration in the example below.

curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

kosmokrator mcp:gateway:install --integration=harvest --write=deny --json

{
  "mcpServers": {
    "kosmokrator-harvest": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=harvest",
        "--write=deny"
      ]
    }
  }
}

Serve Manually

kosmokrator mcp:serve --integration=harvest --write=deny

MCP Tool Names

KosmoKrator exposes integration tools through the gateway with stable names:

MCP Tool Names (12 tools)

MCP tool	Source function	Type
`integration__harvest__harvest_list_time_entries`	`harvest.harvest_list_time_entries`	Read `read`
`integration__harvest__harvest_create_time_entry`	`harvest.harvest_create_time_entry`	Write `write`
`integration__harvest__harvest_get_time_entry`	`harvest.harvest_get_time_entry`	Read `read`
`integration__harvest__harvest_update_time_entry`	`harvest.harvest_update_time_entry`	Write `write`
`integration__harvest__harvest_delete_time_entry`	`harvest.harvest_delete_time_entry`	Write `write`
`integration__harvest__harvest_list_projects`	`harvest.harvest_list_projects`	Read `read`
`integration__harvest__harvest_get_project`	`harvest.harvest_get_project`	Read `read`
`integration__harvest__harvest_list_clients`	`harvest.harvest_list_clients`	Read `read`
`integration__harvest__harvest_list_tasks`	`harvest.harvest_list_tasks`	Read `read`
`integration__harvest__harvest_list_users`	`harvest.harvest_list_users`	Read `read`
`integration__harvest__harvest_get_user`	`harvest.harvest_get_user`	Read `read`
`integration__harvest__harvest_get_current_user`	`harvest.harvest_get_current_user`	Read `read`

Write Access

Start with --write=deny for read-only MCP clients. Use --write=ask or --write=allow only when the client and workspace are trusted.