How do I use Productive.io MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. 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

by KaterinaProtivenskiy

Overview Schema Related Servers Score Discussions

TypeScript

Hybrid

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

This server cannot be installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

Clockify MCP Server
Project Management Workplace & Productivity
aslamanver
A
license
-
quality
D
maintenance
Enables AI assistants to interact with Clockify time tracking API to manage time entries, projects, tasks, and workspaces through natural language commands.
Last updated 2026-02-11
135
4
ISC
TrackingTime MCP Server
Project Management Workplace & Productivity App Automation
ficus33
A
license
-
quality
D
maintenance
Connects 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.
Last updated 2026-04-21
31
MIT
productive-mcp-rb2
Project Management CRM
rubenlangeweg
A
license
A
quality
D
maintenance
Enables interaction with Productive.io for task management, time tracking, budget monitoring, and project overview through natural language.
Last updated 2026-05-25
83
51
ISC
@everhour/mcp-server
Project Management Workplace & Productivity
stefanskiasan
A
license
C
quality
D
maintenance
Provides complete integration with the Everhour API for time tracking, project and task management, enabling AI assistants to manage productivity workflows.
Last updated 2025-07-23
41
41
4
MIT

View all related MCP servers

Related MCP Connectors

Astravue MCP
Manage projects, tasks, time tracking, and team collaboration through natural language.
Ledgy
Log, query, and edit expenses, budgets, and accounts in Ledgy from any MCP-compatible AI assistant.
kesslerio-attio-mcp-server
Connect AI to your Attio CRM. Manage contacts, companies, deals, and sales pipelines. Create tasks…

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/KaterinaProtivenskiy/productive-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

Productive.io MCP Server

Prerequisites

Installation

Configuration

Running

stdio mode (default — for local use)

HTTP mode (for remote/team use)

Connecting to Claude Desktop

Connecting to Claude Code

stdio mode

HTTP mode

Connecting to VS Code

stdio mode

HTTP mode

Available Tools

Invoicing Tools (Draft Only)

Testing with MCP Inspector

Rate Limits

License

Maintenance

Resources

Looking for Admin?

Related MCP Servers

Clockify MCP Server

TrackingTime MCP Server

productive-mcp-rb2

@everhour/mcp-server

Related MCP Connectors

Latest Blog Posts

MCP directory API