Productive.io MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Productive.io MCP Server List my tasks due this week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Productive.io MCP Server
An MCP (Model Context Protocol) server for Productive.io that enables AI assistants like Claude to interact with your Productive.io workspace — managing projects, tasks, time entries, budgets, and more.
Supports two transport modes:
stdio (default) — Claude launches it as a local subprocess
HTTP (with
--httpflag) — runs as an Express web server for remote/team use
Prerequisites
Node.js 18+
A Productive.io account with API access
API Token — generate one in Productive.io under Settings → API integrations
Organization ID — found in your Productive.io account settings
Related MCP server: TrackingTime MCP Server
Installation
git clone <your-repo-url> productive-mcp-server
cd productive-mcp-server
npm install
cp .env.example .env
# Edit .env with your credentials
npm run buildConfiguration
Variable | Required | Description |
| Yes | Your Productive.io API token |
| Yes | Your Productive.io organization ID |
| No | HTTP server port (default: 3000) |
Running
stdio mode (default — for local use)
# Development
npm run dev
# Production (after build)
npm startHTTP mode (for remote/team use)
# Development
npm run dev:http
# Production (after build)
npm run start:httpThe HTTP server exposes:
POST /mcp— MCP protocol endpointGET /health— health check
Connecting to Claude Desktop
Add this to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"productive": {
"command": "node",
"args": ["/absolute/path/to/productive-mcp-server/dist/index.js"],
"env": {
"PRODUCTIVE_API_TOKEN": "your_api_token_here",
"PRODUCTIVE_ORG_ID": "your_org_id_here"
}
}
}
}Connecting to Claude Code
stdio mode
claude mcp add productive -- node /absolute/path/to/productive-mcp-server/dist/index.jsSet the environment variables before running Claude Code, or add them to your shell profile:
export PRODUCTIVE_API_TOKEN=your_api_token_here
export PRODUCTIVE_ORG_ID=your_org_id_hereHTTP mode
Start the server first:
cd /path/to/productive-mcp-server
PRODUCTIVE_API_TOKEN=your_token PRODUCTIVE_ORG_ID=your_org npm run start:httpThen connect Claude Code:
claude mcp add productive --transport http http://localhost:3000/mcpConnecting to VS Code
Add to your VS Code user settings JSON (.vscode/settings.json or user settings):
stdio mode
{
"mcp": {
"servers": {
"productive": {
"command": "node",
"args": ["/absolute/path/to/productive-mcp-server/dist/index.js"],
"env": {
"PRODUCTIVE_API_TOKEN": "your_api_token_here",
"PRODUCTIVE_ORG_ID": "your_org_id_here"
}
}
}
}
}HTTP mode
{
"mcp": {
"servers": {
"productive": {
"type": "http",
"url": "http://localhost:3000/mcp"
}
}
}
}Available Tools
Tool | Description | Key Parameters |
| List/search projects |
|
| Get project by ID |
|
| Create a project |
|
| Update a project |
|
| List/filter tasks |
|
| Get task by ID |
|
| Create a task |
|
| Update a task |
|
| List time entries |
|
| Log a time entry |
|
| List team members |
|
| Get person by ID |
|
| List budgets/deals |
|
| Get deal by ID |
|
| List companies |
|
| Get company by ID |
|
| List bookings |
|
| List services |
|
Invoicing Tools (Draft Only)
All invoice tools create and manage draft invoices only. Finalization (assigning an invoice number) must always be done manually in the Productive.io UI.
Tool | Description | Key Parameters |
| List/filter invoices |
|
| Get full invoice details with line items |
|
| Create a new empty draft invoice |
|
| Update a draft invoice |
|
| Clone an invoice (line items + budget links) |
|
| Clone a client's most recent invoice |
|
| List line items for an invoice |
|
| Add a line item to a draft invoice |
|
| Update an existing line item |
|
| Delete a line item |
|
| List budget links for an invoice |
|
| Link a draft invoice to a budget |
|
| List available document types |
|
| List your company subsidiaries |
|
| List available tax rates |
|
All list tools support page, page_size, and sort parameters.
Testing with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.jsThis opens an interactive UI to test each tool.
Rate Limits
Productive.io enforces:
100 requests per 10 seconds
4,000 requests per 30 minutes
The server implements automatic retry with exponential backoff for 429 responses (up to 3 retries).
License
Available Tools
33 toolsproductive_create_invoiceCreate Draft InvoiceA
Creates a new draft invoice. The invoice will NOT be finalized or assigned a number — finalization must be done manually in the Productive.io UI.
Inputs: company_id (required), document_type_id (required), note, footer, +8 more.
productive_create_invoice_attributionCreate Invoice AttributionC
Link a draft invoice to a budget/deal with an allocated amount. This connects the invoice to a budget for financial tracking in Productive.io.
Inputs: amount (required), deal_id (required), invoice_id (required), date_to, +1 more.
productive_create_invoice_from_previousClone Invoice from PreviousA
Creates a new draft invoice based on a previous invoice, copying line items and budget links. The new invoice is saved as a draft — it will not be finalized or assigned a number. Use productive_get_invoice first to inspect the source invoice.
Inputs: source_invoice_id (required), note, pay_on, subject, +1 more.
productive_create_invoice_like_last_for_clientClone Last Invoice for ClientA
Creates a new draft invoice for a client based on their most recent invoice (or Nth most recent). Copies line items and budget links. The new invoice is saved as a draft — it will not be finalized or assigned a number.
Inputs: company_id (required), note, pay_on, subject, +2 more.
productive_create_line_itemCreate Line ItemA
Create a line item on a draft invoice. Line items define the billable rows (description, quantity, unit_price). Tax is set per line item via tax_rate_id.
Inputs: unit_id (required), quantity (required), invoice_id (required), unit_price (required), +5 more.
productive_create_projectCreate ProjectA
Create a new project in Productive.io. Requires a name and project_type_id. Optionally associate with a company. Use productive_list_companies to find company IDs.
Inputs: name (required), project_type_id (required), company_id, workflow_id.
productive_create_taskCreate TaskA
Create a new task in Productive.io. Requires a title and task_list_id (which belongs to a project). Use productive_list_tasks with a project_id to find available task_list IDs.
Inputs: title (required), task_list_id (required), due_date, project_id, +3 more.
productive_delete_line_itemDelete Line ItemB
Delete a line item from a draft invoice.
Inputs: id (required).
productive_get_companyGet CompanyC
Get a single company by ID from Productive.io with full details.
Inputs: id (required), include.
productive_get_dealGet DealB
Get a single deal/budget by ID from Productive.io with full financial details.
Inputs: id (required), include.
productive_get_invoiceGet InvoiceA
Get full invoice details by ID, including line items, attributions, company, document type, and subsidiary. Use this to inspect an invoice before cloning it.
Inputs: id (required).
productive_get_personGet PersonC
Get details for a specific person by ID from Productive.io.
Inputs: id (required), include.
productive_get_projectGet ProjectA
Get a single Productive.io project by ID with full details. Optionally include related resources like company, project_manager, and workflow.
Inputs: id (required), include.
productive_get_taskGet TaskA
Get a single task by ID from Productive.io with full details including description, dates, and time tracking info.
Inputs: id (required), include.
productive_list_bookingsList BookingsB
List resource bookings/scheduling from Productive.io. Filter by person, project, or date range to see who is booked and when. Booking methods: 1=per day, 2=percentage, 3=total hours.
Inputs: page, sort, after, before, +3 more.
productive_list_companiesList CompaniesB
List companies (clients) in Productive.io. Filter by status or search by name. Use this to find company IDs needed for creating projects or filtering deals.
Inputs: page, sort, query, status, +1 more.
productive_list_dealsList DealsB
List budgets/deals from Productive.io. Filter by project, company, or deal status. Deal status values: 1=open, 2=won, 3=lost. Budgets are deals linked to projects for financial tracking.
Inputs: page, sort, page_size, company_id, +3 more.
productive_list_document_typesList Document TypesA
List available document types in Productive.io. Document types determine the invoice template, locale, and tax defaults. Use this when creating invoices to find the correct document_type_id.
Inputs: page, status, page_size, subsidiary_id.
productive_list_invoice_attributionsList Invoice AttributionsA
List invoice attributions (budget links) for a specific invoice. Attributions connect invoices to budgets/deals for financial tracking.
Inputs: invoice_id (required), page, page_size.
productive_list_invoicesList InvoicesA
List invoices from Productive.io with optional filters. Use this to find invoices for a client, filter by status, or find source invoices to clone.
Inputs: page, sort, deal_id, page_size, +5 more.
productive_list_line_itemsList Line ItemsA
List line items for a specific invoice. Line items determine the invoice amount (quantity x unit_price).
Inputs: invoice_id (required), page, page_size.
productive_list_peopleList PeopleA
List all team members in Productive.io. Returns ID, full name, email, and title. Defaults to page_size=200 to get all members. Use this to find person IDs needed for task assignment or time logging.
Inputs: page, sort, query, status, +2 more.
productive_list_projectsList ProjectsA
List and search Productive.io projects. Supports filtering by company, project type, and archived status. Use this to find project IDs needed for other tools like productive_list_tasks or productive_list_deals.
Inputs: page, sort, query, status, +3 more.
productive_list_servicesList ServicesA
List services (budget line items) in Productive.io. Filter by deal/budget ID. Services belong to a deal/budget and define what work is tracked. Billing types: 1=fixed, 2=time and materials, 3=not billable. Use this to find service IDs needed for logging time.
Inputs: page, sort, deal_id, page_size.
productive_list_subsidiariesList SubsidiariesA
List your company subsidiaries in Productive.io. Subsidiaries represent your company entities and determine the 'Bill From' on invoices. Use this when creating invoices to find the correct subsidiary_id.
Inputs: page, status, page_size.
productive_list_tasksList TasksB
List and filter tasks in Productive.io. Filter by project, assignee, task list, board, or status. Status values: 1=open, 2=closed. Use this to find task IDs and task_list IDs.
Inputs: page, sort, query, status, +4 more.
productive_list_tax_ratesList Tax RatesA
List available tax rates in Productive.io. Tax rates are applied per line item (not per invoice). Use this to find the correct tax_rate_id when creating line items.
Inputs: page, status, page_size.
productive_list_time_entriesList Time EntriesA
List time entries from Productive.io. Filter by person, service, project, or date range. Returns individual entries plus a summary with total hours. Date filters use 'after' and 'before' in YYYY-MM-DD format.
Inputs: page, sort, after, before, +4 more.
productive_log_timeLog TimeA
Create a new time entry in Productive.io. Requires person_id, service_id, and date. You can specify duration either as 'time' in minutes OR as 'started_at'/'ended_at' times (HH:MM format). When started_at and ended_at are provided, the duration is auto-calculated and the entry shows as a time block. ALWAYS prefer started_at/ended_at when the user mentions start/end times (e.g. '9 to 5', '09:00-17:00'). Use productive_list_people to find person IDs. Use productive_list_services to find service IDs.
Inputs: date (required), person_id (required), service_id (required), note, +4 more.
productive_update_invoiceUpdate Draft InvoiceA
Update an existing draft invoice. Cannot be used to finalize an invoice. Only draft invoices (not yet finalized) can be updated.
Inputs: id (required), note, footer, pay_on, +4 more.
productive_update_line_itemUpdate Line ItemA
Update an existing line item on a draft invoice (description, quantity, unit_price, discount).
Inputs: id (required), unit_id, discount, quantity, +3 more.
productive_update_projectUpdate ProjectB
Update an existing Productive.io project. Use productive_get_project first to see current values.
Inputs: id (required), name, project_type_id, project_manager_id.
productive_update_taskUpdate TaskB
Update an existing task in Productive.io. Use productive_get_task first to see current values.
Inputs: id (required), title, closed, due_date, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 33 tools
Most tools target distinct resources and actions (e.g., get_task vs list_tasks, log_time vs list_time_entries). However, the three invoice-creation tools (create_invoice, create_invoice_from_previous, create_invoice_like_last_for_client) overlap in purpose and could be confused, though descriptions differentiate them.
All tools use the productive_ prefix followed by a consistent snake_case verb_noun pattern (list_projects, get_task, create_invoice, update_line_item, delete_line_item). No mixing of camelCase or inconsistent verb styles.
33 tools is heavy for a single server. While the broad domain (projects, tasks, time, invoices, budgets, etc.) might justify many tools, the count exceeds the typical 3-15 range and includes several granular read-only reference tools (document_types, subsidiaries, tax_rates) that contribute to bloat.
Coverage is heavily read-oriented. Many core resources lack full CRUD: no delete for projects, tasks, time entries, companies, people, deals, or bookings; no update for time entries, bookings, services, deals, people, or companies. Common workflows (e.g., updating a company, creating a deal) will fail.
Related MCP Connectors
Connects AI assistants to TrackingTime for querying time entries, projects, tasks, customers, and team data using natural language.
Manage Avaza projects, tasks, timesheets, expenses, invoices, and scheduling from AI assistants.
Manage projects, tasks, time tracking, and team collaboration through natural language.
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Clockify time tracking API to manage time entries, projects, tasks, and workspaces through natural language commands.33 npm5ISC
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to the TrackingTime API v4 for managing projects, tasks, and team assignments. Users can start or stop timers, log manual time entries, and organize project workflows using natural language.10 npmMIT
- AlicenseAqualityDmaintenanceEnables interaction with Productive.io for task management, time tracking, budget monitoring, and project overview through natural language.8321 npmISC
- AlicenseCqualityDmaintenanceProvides complete integration with the Everhour API for time tracking, project and task management, enabling AI assistants to manage productivity workflows.4157 npm4MIT