berwickgeek/productive-mcp

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

13 stars 14 forks Качество 72 Тренд 34

An MCP (Model Context Protocol) server that enables Claude Desktop, Claude Code, and other MCP-compatible clients to interact with the Productive.io API.

Обзор

An MCP (Model Context Protocol) server that enables Claude Desktop, Claude Code, and other MCP-compatible clients to interact with the Productive.io API. - : get_task_overview returns everything about one task in a single call, so reading an issue does not cost a dozen round trips - : List companies and projects with status filtering - : Full CRUD with archive/restore for organizing project content - : Full lifecycle management — create, update, archive/restore, copy, move, reposition - : List, create, update, delete tasks with various filters - : Create and list subtasks under parent tasks - : Comments, status updates, sprint assignment, repositioning - : Full CRUD with pin/unpin and reactions - : Checklist items on tasks — create, update, close/reopen, delete - : Full document management with nested page hierarchies, move, and copy - : List people in your organization with filtering options - : List and work with workflow statuses for proper task status updates - : List and create...

README

Показан фрагмент оригинального README. Открыть оригинал.

Productive.io MCP Server

An MCP (Model Context Protocol) server that enables Claude Desktop, Claude Code, and other MCP-compatible clients to interact with the Productive.io API.

Features

Task Briefing: get_task_overview returns everything about one task in a single call, so reading an issue does not cost a dozen round trips
Companies & Projects: List companies and projects with status filtering
Folders: Full CRUD with archive/restore for organizing project content
Task Lists: Full lifecycle management — create, update, archive/restore, copy, move, reposition
Task Management: List, create, update, delete tasks with various filters
Subtasks: Create and list subtasks under parent tasks
Task Operations: Comments, status updates, sprint assignment, repositioning
Comments: Full CRUD with pin/unpin and reactions
Todos: Checklist items on tasks — create, update, close/reopen, delete
Pages/Docs: Full document management with nested page hierarchies, move, and copy
People Management: List people in your organization with filtering options
Workflow Management: List and work with workflow statuses for proper task status updates
Time Tracking: List and create time entries with service/deal integration
User Context: Supports “me” references when PRODUCTIVE_USER_ID is configured
Activity Tracking: View activities and recent updates across your organization

Installation

Via npm (Recommended)

Install globally:

npm install -g productive-mcp

Or run directly with npx (no installation required):

npx productive-mcp

From Source

Clone this repository
Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```

Configuration

Getting Your Credentials

To obtain your Productive.io credentials:

Log in to Productive.io
Go to Settings → API integrations
Generate a new token (choose read-only for safety, or full access for task creation)
Copy the token and organization ID

To find your user ID:

You can use the API to list people and find your ID
Or check the URL when viewing your profile in Productive.io

Environment Variables

The server requires the following environment variables:

Variable	Required	Description
`PRODUCTIVE_API_TOKEN`	Yes	Your Productive.io API token
`PRODUCTIVE_ORG_ID`	Yes	Your organization ID
`PRODUCTIVE_USER_ID`	No	Your user ID (required for `my_tasks` tool)

Usage with Claude Desktop

Add the server to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Using npx (Recommended)

{
  "mcpServers": {

Открыть полный README на GitHub

Установка

npx -y productive-mcp

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "productive": {
      "command": "npx",
      "args": ["-y", "productive-mcp"],
      "env": {
        "PRODUCTIVE_API_TOKEN": "your_api_token_here",
        "PRODUCTIVE_ORG_ID": "your_organization_id_here",
        "PRODUCTIVE_USER_ID": "your_user_id_here"
      }
    }
  }
}