Productive Simple MCP

Quick search across projects, tasks, pages, and actions.

This tool provides fast, comprehensive search across all Productive content types including projects, tasks, pages, and actions. It's optimized for quick lookups and general search queries.

Returns: Search results from Productive API including: - Matching projects, tasks, pages, and actions - Relevance scores and metadata - Full entity details for each match

Examples: quick_search("red") # Search for "red" across all content types quick_search("project", search_types=["project"]) # Search only in projects quick_search("meeting", deep_search=False) # Quick search without deep scan

Get a summarized feed of recent activities and updates.

Returns recent changes, task updates, comments, new documents and activities in chronological order.

Examples: get_recent_activity() # Last 24 hours, all activity get_recent_activity(hours=168) # Last week get_recent_activity(hours=48, project_id=343136) # Last 2 days on specific project get_recent_activity(hours=24, user_id=12345) # What a specific user did today get_recent_activity(hours=24, activity_type=1) # Only comments from last day get_recent_activity(hours=168, item_type='Task') # Task activities from last week get_recent_activity(hours=168, event_type='edit') # Task edits from last week get_tasks(extra_filters={'filter[status][eq]': 2}, sort='-updated_at', page_size=10) # Recently closed tasks

Get all projects with basic information.

Returns project data including:

• Project ID, name, and number

• Creation and last activity timestamps

• Archived status (if applicable)

• Webapp URL for direct access

Get tasks with optional filtering and pagination.

Supports filtering by project, assignee, status, and other criteria. All parameters are optional - omit to fetch all tasks.

Example of extra_filters:

• filter[status][eq]=1: Open tasks

• filter[status][eq]=2: Closed tasks

• filter[workflow_status_category_id][eq]=3: Workflow closed status

• filter[board_status][eq]=1: Active board tasks

Returns: Dictionary of tasks matching the provided filters

Get detailed task information by its internal ID.

Use this when you have the internal task ID (e.g., 14677418). For looking up tasks by their project-specific number (e.g., #960), use get_project_task instead.

Returns task details including:

• Task title, description, and status (open/closed)

• Due date, start date, and creation/update timestamps

• Time tracking: initial estimate, remaining time, billable time, and worked time (in minutes)

• Todo counts: total and open

Get comprehensive history for a specific task.

Returns aggregated task history including:

• Status history: Timeline of status changes with timestamps and responsible users

• Assignment history: Who worked on the task and when assignments changed

• Milestones: Key deliverables and completion markers from comments and activities

• Activity summary: Counts of comments, changes, status updates, assignments, and milestones

Examples: get_task_history(14677921) # Default 30-day history get_task_history(14677921, hours=168) # Last week only get_task_history(14677921,1 hours=24) # Last 24 hours

Get all comments across projects and tasks with full context.

Returns comprehensive comment data including:

• Comment text, author, and timestamp

• Parent entity (project, task, or other) with details

• Discussion threads and replies

• Attachments and file references

• Mentions of team members or clients

Get all todo checklist items across all tasks and projects.

Returns comprehensive todo data including:

• Checkbox items within tasks for granular tracking

• Completion status and assignee information

• Parent task details with project context

• Due dates and priority relative to parent task

• Estimated vs actual time for checklist items

Get specific todo checklist item details with full task context.

Returns detailed todo information including:

• Checkbox item text and completion status

• Parent task with project and client details

• Assignee and team member information

• Due date relative to parent task timeline

• Time estimates vs actual completion time

• Related comments and file attachments

Get all pages/documents with optional filtering.

Pages in Productive are documents that can contain rich text content, attachments, and are organized within projects.

Returns: Dictionary containing pages with content, metadata, and relationships

Example: get_pages(project_id=1234) # Get all pages for a specific project

Get specific page/document details with full content.

Returns: Dictionary with complete page details including JSON-formatted content

Get all team members/people with optional pagination.

Returns team member data including:

• Person ID, name, and email

• Role and title information

• Last seen and join dates

• Avatar and contact information

Get detailed information about a specific team member/person.

Returns comprehensive person details including:

• Full name, email, and contact information

• Role, title, and organizational details

• Activity timestamps (joined, last seen)

• Custom fields and additional metadata

• Avatar and profile information

Get all attachments/files with optional filtering.

Attachments are files (PDFs, images, documents) that can be associated with various Productive entities like tasks, comments, expenses, etc.

Returns: Dictionary containing attachment metadata (name, type, size, relationships) Note: This provides metadata only, not actual file content