Skip to main content
Glama
Productive.io MCP Server

Productive.io MCP Server

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 --http flag) — 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 build

Configuration

Variable

Required

Description

PRODUCTIVE_API_TOKEN

Yes

Your Productive.io API token

PRODUCTIVE_ORG_ID

Yes

Your Productive.io organization ID

PORT

No

HTTP server port (default: 3000)

Running

stdio mode (default — for local use)

# Development
npm run dev

# Production (after build)
npm start

HTTP mode (for remote/team use)

# Development
npm run dev:http

# Production (after build)
npm run start:http

The HTTP server exposes:

  • POST /mcp — MCP protocol endpoint

  • GET /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.js

Set 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_here

HTTP mode

Start the server first:

cd /path/to/productive-mcp-server
PRODUCTIVE_API_TOKEN=your_token PRODUCTIVE_ORG_ID=your_org npm run start:http

Then connect Claude Code:

claude mcp add productive --transport http http://localhost:3000/mcp

Connecting 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

productive_list_projects

List/search projects

company_id, project_type_id, status, query

productive_get_project

Get project by ID

id, include

productive_create_project

Create a project

name, project_type_id, company_id

productive_update_project

Update a project

id, name, project_type_id

productive_list_tasks

List/filter tasks

project_id, assignee_id, status, query

productive_get_task

Get task by ID

id, include

productive_create_task

Create a task

title, task_list_id, assignee_id

productive_update_task

Update a task

id, title, closed, assignee_id

productive_list_time_entries

List time entries

person_id, project_id, after, before

productive_log_time

Log a time entry

person_id, service_id, date, time

productive_list_people

List team members

status, company_id, query

productive_get_person

Get person by ID

id, include

productive_list_deals

List budgets/deals

project_id, company_id, deal_status

productive_get_deal

Get deal by ID

id, include

productive_list_companies

List companies

status, query

productive_get_company

Get company by ID

id, include

productive_list_bookings

List bookings

person_id, project_id, after, before

productive_list_services

List services

deal_id

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

productive_list_invoices

List/filter invoices

company_id, deal_id, invoice_status, date range

productive_get_invoice

Get full invoice details with line items

id

productive_create_invoice

Create a new empty draft invoice

company_id, document_type_id, subsidiary_id

productive_update_invoice

Update a draft invoice

id, subject, note, dates

productive_create_invoice_from_previous

Clone an invoice (line items + budget links)

source_invoice_id, optional overrides

productive_create_invoice_like_last_for_client

Clone a client's most recent invoice

company_id, how_many_back

productive_list_line_items

List line items for an invoice

invoice_id

productive_create_line_item

Add a line item to a draft invoice

invoice_id, description, quantity, unit_price, unit_id

productive_update_line_item

Update an existing line item

id, description, quantity, unit_price

productive_delete_line_item

Delete a line item

id

productive_list_invoice_attributions

List budget links for an invoice

invoice_id

productive_create_invoice_attribution

Link a draft invoice to a budget

invoice_id, deal_id, amount

productive_list_document_types

List available document types

subsidiary_id, status

productive_list_subsidiaries

List your company subsidiaries

status

productive_list_tax_rates

List available tax rates

status

All list tools support page, page_size, and sort parameters.

Testing with MCP Inspector

npx @modelcontextprotocol/inspector node dist/index.js

This 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 tools
productive_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

    B3.3/5.0

    Scored across 33 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness2/5

    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

    Related MCP Servers