Plutio Skill

Integrate with Plutio for project and task management via REST API.

Platforms: Works with Linux/macOS (bash) and Windows (PowerShell 7). See references/powershell-workflows.md for PowerShell-specific examples.

Setup

Complete setup guide: See references/setup-guide.md for:

• - How to get API credentials from Plutio
• Configuring via OpenClaw chat (recommended)
• Command-line setup for Linux, macOS, and Windows
• Secure credential storage (Bitwarden, environment variables)
• Troubleshooting common issues

Quick summary:

1. 1. Get credentials from Plutio (Settings > API > Create Application)
2. Ask OpenClaw to configure (easiest): "Setup Plutio with Client ID: XXX and Secret: YYY"
3. Or set environment variables:

1. 4. Python 3 must be installed

The skill caches access tokens locally (valid for ~1 hour), then automatically refreshes when needed.

Quick Start

List all projects

List tasks in a project

Create a task

Note: To make tasks appear in the Plutio UI, you must provide both --board-id (Task List board ID) and --group-id (column/group ID like Backlog, In Progress, Done).

List people (team members)

Common Operations

Create a task with all fields

Supported fields when creating/updating tasks:

• - title - Task name
• INLINECODE5 - Task details
• INLINECODE6 - open, in_progress, closed, or custom status name
• INLINECODE10 - low, medium, high, INLINECODE14
• INLINECODE15 - Person ID to assign task to
• INLINECODE16 - ISO format (YYYY-MM-DD)
• INLINECODE17 - Comma-separated label IDs
• INLINECODE18 - JSON string with custom field values

Close a task

API Reference

See references/api-endpoints.md for:

• - Full endpoint documentation
• Response schemas
• Field descriptions
• Rate limits and pagination

How It Works

1. 1. Authentication: Exchanges app key + secret for temporary access token
2. API Calls: Uses token for authenticated requests to Plutio REST API
3. Token Caching: Stores token locally for faster subsequent calls
4. Error Handling: Reports API errors clearly with troubleshooting hints

Important Notes on Plutio v1.11 API

Supported Operations:

• - ✅ List projects
• ✅ List tasks (all tasks in workspace or by board)
• ✅ Create tasks (with board and group IDs)
• ✅ List people/team members

Key Requirements for v1.11:

• - Tasks need both taskBoardId AND taskGroupId to appear in the Plutio UI
• Tasks without these parameters are created but remain hidden from the interface
• Get your board and group IDs from the Plutio project's Task List

Known Limitations (v1.11):

• - projectId parameter doesn't work - use taskBoardId instead
• Task creation supports: title, board ID, group ID only
• Other fields (status, priority, description) are not supported in the create endpoint
• Task updates via API have permission restrictions (use Plutio UI)
• To add details to tasks, edit them directly in Plutio UI
• Contact Plutio support for advanced field support

Troubleshooting

"Unauthorized" error:

• - Verify Client ID and Secret are copied exactly from Plutio Settings > API manager
• Check that the API application is created and visible in your API manager
• Ensure you're using v1.11 or later

"Project not found": Verify project ID with INLINECODE23

"Rate limited": Plutio has 1000 calls/hour limit. Wait before retrying.

Tasks not appearing in results: Check the Plutio UI directly - the API may have caching delays.

Integration Examples

For PowerShell Users

Complete PowerShell 7 workflows and examples: See references/powershell-workflows.md for:

• - Daily task briefings
• Batch task operations
• Integration with Windows Task Scheduler
• Error handling patterns

For OpenClaw Integration

In OpenClaw, you could create a script that:

1. 1. Checks calendar for upcoming deadline
2. Queries Plutio for tasks due that day
3. Sends reminder via Matrix

See the scripts/ folder and references/ for implementation examples.