berwickgeek/productive-mcp

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

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": {

GitHub에서 전체 README 보기

설치

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"
      }
    }
  }
}