
taiste/harvest-mcp-server
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
taiste/harvest-mcp-server - кандидат на сервер MCP, импортированный из https://github.com/taiste/harvest-mcp-server.
Обзор
taiste/harvest-mcp-server - кандидат на сервер MCP, импортированный из https://github.com/taiste/harvest-mcp-server.
Обзор (машинный перевод)
Этот сервер MCP (Model Context Protocol) обеспечивает интеграцию с API для отслеживания времени сбора урожая и управления проектами. Это позволяет Клоду и другим ИИ-ассистентам, совместимым с MCP, взаимодействовать с вашей учетной записью Harvest, помогая вам управлять временными записями, проектами, клиентами и многим другим.
Особенности
Сервер обеспечивает следующую функциональность:
Пользователи
- Список пользователей Получить данные пользователя
###Время пришло
- Список временных записей с вариантами фильтрации Создание новых временных записей
- Старт/стоп таймеры
- Подробности ввода запроса времени
- Получить непредставленные таблицы времени (временные записи еще не представлены для утверждения)
###Проекты Список проектов с опциями фильтрации (по клиенту, is active, updated since, page, per page)
- Получить подробную информацию о проекте
Создание новых проектов
Обновление существующих проектов (также используется для архивирования: pass
is_active=False) - Удаление проектов (деструктивное - также удаляет временные записи и расходы проекта, хотя счета-фактуры сохраняются; вместо этого рекомендуется архивирование)
Задания
Перечислить задания (в масштабах всего счета или в рамках проекта)
- Получить подробную информацию о назначении задания Создание новых заданий (ссылка задачи на проект)
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
Harvest MCP Server
This MCP (Model Context Protocol) server provides integration with the Harvest time tracking and project management API. It allows Claude and other MCP-compatible AI assistants to interact with your Harvest account, helping you manage time entries, projects, clients, and more.
Features
The server provides the following functionality:
Users
- List users
- Get user details
Time Entries
- List time entries with filtering options
- Create new time entries
- Start/stop timers
- Query time entry details
- Get unsubmitted timesheets (time entries not yet submitted for approval)
Projects
- List projects with filtering options (by client, is_active, updated_since, page, per_page)
- Retrieve detailed project information
- Create new projects
- Update existing projects (also used to archive: pass
is_active=False) - Delete projects (destructive — also deletes the project’s time entries and expenses, though invoices are retained; archiving is recommended instead)
Task Assignments
- List task assignments (account-wide or scoped to a project)
- Retrieve detailed task assignment information
- Create new task assignments (link a task to a project)
- Update existing task assignments
- Delete task assignments (only when no time entries are logged against them)
User Assignments
- List user assignments (account-wide or scoped to a project)
- Retrieve detailed user assignment information
- Create new user assignments (link a user to a project)
- Update existing user assignments
- Delete user assignments (only when no time entries or expenses are logged against them)
Clients
- List clients with filtering options
- Retrieve detailed client information
Tasks
- List available tasks with filtering options
Estimates
- List estimates with filtering options (by client, state, date range, updated_since)
- Retrieve detailed estimate information
- Look up an estimate by its user-facing number (e.g. “79”)
- List messages associated with an estimate
- Create new estimates with line items
- Update existing estimates (add/update/delete line items via
_destroy) - Change estimate state (send, accept, decline, re-open) without sending email
- Send estimate messages (emails the estimate to recipients)
- Delete estimates
Setup Instructions
Prerequisites
- Python 3.10 or higher
- Harvest account with API access
- Harvest API key and Account ID
Integrating with Claude Desktop
- Create or edit your Claude Desktop configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows (MSIX installs — the default from claude.ai/download):
%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json
- macOS:
Установка
This server does not publish a one-line install command.
Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →Конфигурация
{
"mcpServers": {
"harvest": {
"command": "uv",
"args": [
"run",
"--directory",
"change_directory",
"harvest-mcp-server.py"
],
"env": {
"HARVEST_ACCOUNT_ID": "account_id",
"HARVEST_API_KEY": "api_key"
}
}
}
}