harvest-mcp 0.1.0

Harvest MCP Server for managing Harvest via the Model Context Protocol

Harvest MCP Server

A Model Context Protocol (MCP) server for interacting with Harvest time tracking and project management APIs.

Installation

After publishing to PyPI, run the installed CLI with uvx (same pattern as other Barie MCP servers):

uvx harvest-mcp-server --help

For a local wheel (absolute path to the built .whl):

uvx --from /absolute/path/to/harvest_mcp-0.1.0-py3-none-any.whl harvest-mcp-server --help

Editable install for development:

pip install -e .

Usage

Recommended (stdio MCP): use uvx so --from applies to the tool environment, not to the python interpreter.

uvx harvest-mcp-server \
  --account-id "<harvest_account_id>" \
  --api-key "<harvest_api_key>" \
  --read-only "false"

If the package is installed in the current environment (pip install -e . or pip install .):

python -m harvest_mcp_server \
  --account-id "<harvest_account_id>" \
  --api-key "<harvest_api_key>" \
  --read-only "false"

Required arguments

• --account-id: Harvest account ID
• --api-key: Harvest API key

Optional arguments

• --read-only: Enable read-only mode (true/false), default false

Features

• Users (list, detail)
• Time entries (list, create, start/stop timers, details, unsubmitted)
• Projects, clients, and tasks lookup
• Estimates lifecycle (list/detail/lookup/create/update/state-change/send/delete)
• Optional read-only mode for safe operation

MCP Configuration Example

Using uvx and a local wheel (note: harvest-mcp-server after --from is the console script name, not a python argument):

{
  "mcpServers": {
    "harvest": {
      "command": "uvx",
      "args": [
        "--from",
        "/absolute/path/to/harvest_mcp-0.1.0-py3-none-any.whl",
        "harvest-mcp-server",
        "--account-id",
        "YOUR_HARVEST_ACCOUNT_ID",
        "--api-key",
        "YOUR_HARVEST_API_KEY",
        "--read-only",
        "true"
      ]
    }
  }
}

Using python -m when the package is installed in the interpreter you launch:

{
  "mcpServers": {
    "harvest": {
      "command": "python",
      "args": [
        "-m",
        "harvest_mcp_server",
        "--account-id",
        "YOUR_HARVEST_ACCOUNT_ID",
        "--api-key",
        "YOUR_HARVEST_API_KEY",
        "--read-only",
        "true"
      ]
    }
  }
}

Development

From the harvest-mcp-server directory:

pip install -e .
harvest-mcp-server --help

Build a wheel:

python -m build