@studiometa/productive-mcp 0.6.4 → 0.8.0

package/dist/tools.js

@@ -1,7 +1,14 @@
 const TOOLS = [
   {
     name: "productive",
-    description: "Productive.io API. Resources: projects, time, tasks, services, people, companies, comments, timers, deals, bookings. Actions: list, get, create, update (varies by resource), start/stop (timers), me (people). Filters: project_id, person_id, service_id, company_id, after/before (dates).",
+    description: "Productive.io API. Resources: projects, time, tasks, services, people, companies, comments, timers, deals, bookings, reports. Actions: list, get, create, update (varies by resource), start/stop (timers), me (people), help (documentation). Use query for text search on list actions. Reports: use resource=reports, action=get with report_type. Filters: project_id, person_id, service_id, company_id, after/before (dates). Use include to fetch related data. Use compact=false for full details (default for get, true for list). Use action=help with a resource for detailed documentation.",
+    annotations: {
+      title: "Productive.io",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    },
     inputSchema: {
       type: "object",
       properties: {
@@ -17,18 +24,32 @@ const TOOLS = [
             "comments",
             "timers",
             "deals",
-            "bookings"
+            "bookings",
+            "reports"
           ]
         },
         action: {
           type: "string",
-          enum: ["list", "get", "create", "update", "me", "start", "stop"]
+          enum: ["list", "get", "create", "update", "me", "start", "stop", "help"],
+          description: 'Action to perform. Use "help" for detailed documentation on a resource.'
         },
         id: { type: "string" },
         filter: { type: "object" },
         page: { type: "number" },
         per_page: { type: "number" },
-        compact: { type: "boolean" },
+        compact: {
+          type: "boolean",
+          description: "Compact output (default: true for list, false for get)"
+        },
+        include: {
+          type: "array",
+          items: { type: "string" },
+          description: 'Related resources to include (e.g., ["project", "assignee", "comments"])'
+        },
+        query: {
+          type: "string",
+          description: "Text search query for list actions (searches name/title fields)"
+        },
         // Common fields
         person_id: { type: "string" },
         service_id: { type: "string" },
@@ -53,7 +74,28 @@ const TOOLS = [
         // Booking fields
         started_on: { type: "string" },
         ended_on: { type: "string" },
-        event_id: { type: "string" }
+        event_id: { type: "string" },
+        // Report fields
+        report_type: {
+          type: "string",
+          enum: [
+            "time_reports",
+            "project_reports",
+            "budget_reports",
+            "person_reports",
+            "invoice_reports",
+            "payment_reports",
+            "service_reports",
+            "task_reports",
+            "company_reports",
+            "deal_reports",
+            "timesheet_reports"
+          ]
+        },
+        group: { type: "string" },
+        from: { type: "string" },
+        to: { type: "string" },
+        status: { type: "string" }
       },
       required: ["resource", "action"]
     }
@@ -63,6 +105,13 @@ const STDIO_ONLY_TOOLS = [
   {
     name: "productive_configure",
     description: "Configure Productive.io credentials",
+    annotations: {
+      title: "Configure Productive",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     inputSchema: {
       type: "object",
       properties: {
@@ -76,6 +125,13 @@ const STDIO_ONLY_TOOLS = [
   {
     name: "productive_get_config",
     description: "Get current configuration",
+    annotations: {
+      title: "Get Productive Config",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     inputSchema: {
       type: "object",
       properties: {}

package/dist/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sources":["../src/tools.ts"],"sourcesContent":["import type { Tool } from '@modelcontextprotocol/sdk/types.js';\n\n/**\n * Single consolidated tool for Productive.io MCP server\n *\n * Optimized for minimal token overhead (~170 tokens vs ~1300 for individual tools)\n */\nexport const TOOLS: Tool[] = [\n  {\n    name: 'productive',\n    description:\n      'Productive.io API. Resources: projects, time, tasks, services, people, companies, comments, timers, deals, bookings. Actions: list, get, create, update (varies by resource), start/stop (timers), me (people). Filters: project_id, person_id, service_id, company_id, after/before (dates).',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        resource: {\n          type: 'string',\n          enum: [\n            'projects',\n            'time',\n            'tasks',\n            'services',\n            'people',\n            'companies',\n            'comments',\n            'timers',\n            'deals',\n            'bookings',\n          ],\n        },\n        action: {\n          type: 'string',\n          enum: ['list', 'get', 'create', 'update', 'me', 'start', 'stop'],\n        },\n        id: { type: 'string' },\n        filter: { type: 'object' },\n        page: { type: 'number' },\n        per_page: { type: 'number' },\n        compact: { type: 'boolean' },\n        // Common fields\n        person_id: { type: 'string' },\n        service_id: { type: 'string' },\n        task_id: { type: 'string' },\n        company_id: { type: 'string' },\n        time: { type: 'number' },\n        date: { type: 'string' },\n        note: { type: 'string' },\n        // Task fields\n        title: { type: 'string' },\n        project_id: { type: 'string' },\n        task_list_id: { type: 'string' },\n        description: { type: 'string' },\n        assignee_id: { type: 'string' },\n        // Company fields\n        name: { type: 'string' },\n        // Comment fields\n        body: { type: 'string' },\n        deal_id: { type: 'string' },\n        // Timer fields\n        time_entry_id: { type: 'string' },\n        // Booking fields\n        started_on: { type: 'string' },\n        ended_on: { type: 'string' },\n        event_id: { type: 'string' },\n      },\n      required: ['resource', 'action'],\n    },\n  },\n];\n\n/**\n * Additional tools only available in stdio mode (local execution)\n * These tools manage persistent configuration\n */\nexport const STDIO_ONLY_TOOLS: Tool[] = [\n  {\n    name: 'productive_configure',\n    description: 'Configure Productive.io credentials',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        organizationId: { type: 'string' },\n        apiToken: { type: 'string' },\n        userId: { type: 'string' },\n      },\n      required: ['organizationId', 'apiToken'],\n    },\n  },\n  {\n    name: 'productive_get_config',\n    description: 'Get current configuration',\n    inputSchema: {\n      type: 'object',\n      properties: {},\n    },\n  },\n];\n"],"names":[],"mappings":"AAOO,MAAM,QAAgB;AAAA,EAC3B;AAAA,IACE,MAAM;AAAA,IACN,aACE;AAAA,IACF,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,UAAU;AAAA,UACR,MAAM;AAAA,UACN,MAAM;AAAA,YACJ;AAAA,YACA;AAAA,YACA;AAAA,YACA;AAAA,YACA;AAAA,YACA;AAAA,YACA;AAAA,YACA;AAAA,YACA;AAAA,YACA;AAAA,UAAA;AAAA,QACF;AAAA,QAEF,QAAQ;AAAA,UACN,MAAM;AAAA,UACN,MAAM,CAAC,QAAQ,OAAO,UAAU,UAAU,MAAM,SAAS,MAAM;AAAA,QAAA;AAAA,QAEjE,IAAI,EAAE,MAAM,SAAA;AAAA,QACZ,QAAQ,EAAE,MAAM,SAAA;AAAA,QAChB,MAAM,EAAE,MAAM,SAAA;AAAA,QACd,UAAU,EAAE,MAAM,SAAA;AAAA,QAClB,SAAS,EAAE,MAAM,UAAA;AAAA;AAAA,QAEjB,WAAW,EAAE,MAAM,SAAA;AAAA,QACnB,YAAY,EAAE,MAAM,SAAA;AAAA,QACpB,SAAS,EAAE,MAAM,SAAA;AAAA,QACjB,YAAY,EAAE,MAAM,SAAA;AAAA,QACpB,MAAM,EAAE,MAAM,SAAA;AAAA,QACd,MAAM,EAAE,MAAM,SAAA;AAAA,QACd,MAAM,EAAE,MAAM,SAAA;AAAA;AAAA,QAEd,OAAO,EAAE,MAAM,SAAA;AAAA,QACf,YAAY,EAAE,MAAM,SAAA;AAAA,QACpB,cAAc,EAAE,MAAM,SAAA;AAAA,QACtB,aAAa,EAAE,MAAM,SAAA;AAAA,QACrB,aAAa,EAAE,MAAM,SAAA;AAAA;AAAA,QAErB,MAAM,EAAE,MAAM,SAAA;AAAA;AAAA,QAEd,MAAM,EAAE,MAAM,SAAA;AAAA,QACd,SAAS,EAAE,MAAM,SAAA;AAAA;AAAA,QAEjB,eAAe,EAAE,MAAM,SAAA;AAAA;AAAA,QAEvB,YAAY,EAAE,MAAM,SAAA;AAAA,QACpB,UAAU,EAAE,MAAM,SAAA;AAAA,QAClB,UAAU,EAAE,MAAM,SAAA;AAAA,MAAS;AAAA,MAE7B,UAAU,CAAC,YAAY,QAAQ;AAAA,IAAA;AAAA,EACjC;AAEJ;AAMO,MAAM,mBAA2B;AAAA,EACtC;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,gBAAgB,EAAE,MAAM,SAAA;AAAA,QACxB,UAAU,EAAE,MAAM,SAAA;AAAA,QAClB,QAAQ,EAAE,MAAM,SAAA;AAAA,MAAS;AAAA,MAE3B,UAAU,CAAC,kBAAkB,UAAU;AAAA,IAAA;AAAA,EACzC;AAAA,EAEF;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY,CAAA;AAAA,IAAC;AAAA,EACf;AAEJ;"}
+{"version":3,"file":"tools.js","sources":["../src/tools.ts"],"sourcesContent":["import type { Tool } from '@modelcontextprotocol/sdk/types.js';\n\n/**\n * Single consolidated tool for Productive.io MCP server\n *\n * Optimized for minimal token overhead (~170 tokens vs ~1300 for individual tools)\n *\n * MCP Annotations (for MCP directory compliance):\n * - readOnlyHint: false - Tool can create/update data\n * - destructiveHint: false - Tool does not permanently delete data\n * - idempotentHint: false - Create actions are not idempotent\n * - openWorldHint: true - Tool interacts with external Productive.io API\n */\nexport const TOOLS: Tool[] = [\n  {\n    name: 'productive',\n    description:\n      'Productive.io API. Resources: projects, time, tasks, services, people, companies, comments, timers, deals, bookings, reports. Actions: list, get, create, update (varies by resource), start/stop (timers), me (people), help (documentation). Use query for text search on list actions. Reports: use resource=reports, action=get with report_type. Filters: project_id, person_id, service_id, company_id, after/before (dates). Use include to fetch related data. Use compact=false for full details (default for get, true for list). Use action=help with a resource for detailed documentation.',\n    annotations: {\n      title: 'Productive.io',\n      readOnlyHint: false,\n      destructiveHint: false,\n      idempotentHint: false,\n      openWorldHint: true,\n    },\n    inputSchema: {\n      type: 'object',\n      properties: {\n        resource: {\n          type: 'string',\n          enum: [\n            'projects',\n            'time',\n            'tasks',\n            'services',\n            'people',\n            'companies',\n            'comments',\n            'timers',\n            'deals',\n            'bookings',\n            'reports',\n          ],\n        },\n        action: {\n          type: 'string',\n          enum: ['list', 'get', 'create', 'update', 'me', 'start', 'stop', 'help'],\n          description: 'Action to perform. Use \"help\" for detailed documentation on a resource.',\n        },\n        id: { type: 'string' },\n        filter: { type: 'object' },\n        page: { type: 'number' },\n        per_page: { type: 'number' },\n        compact: {\n          type: 'boolean',\n          description: 'Compact output (default: true for list, false for get)',\n        },\n        include: {\n          type: 'array',\n          items: { type: 'string' },\n          description: 'Related resources to include (e.g., [\"project\", \"assignee\", \"comments\"])',\n        },\n        query: {\n          type: 'string',\n          description: 'Text search query for list actions (searches name/title fields)',\n        },\n        // Common fields\n        person_id: { type: 'string' },\n        service_id: { type: 'string' },\n        task_id: { type: 'string' },\n        company_id: { type: 'string' },\n        time: { type: 'number' },\n        date: { type: 'string' },\n        note: { type: 'string' },\n        // Task fields\n        title: { type: 'string' },\n        project_id: { type: 'string' },\n        task_list_id: { type: 'string' },\n        description: { type: 'string' },\n        assignee_id: { type: 'string' },\n        // Company fields\n        name: { type: 'string' },\n        // Comment fields\n        body: { type: 'string' },\n        deal_id: { type: 'string' },\n        // Timer fields\n        time_entry_id: { type: 'string' },\n        // Booking fields\n        started_on: { type: 'string' },\n        ended_on: { type: 'string' },\n        event_id: { type: 'string' },\n        // Report fields\n        report_type: {\n          type: 'string',\n          enum: [\n            'time_reports',\n            'project_reports',\n            'budget_reports',\n            'person_reports',\n            'invoice_reports',\n            'payment_reports',\n            'service_reports',\n            'task_reports',\n            'company_reports',\n            'deal_reports',\n            'timesheet_reports',\n          ],\n        },\n        group: { type: 'string' },\n        from: { type: 'string' },\n        to: { type: 'string' },\n        status: { type: 'string' },\n      },\n      required: ['resource', 'action'],\n    },\n  },\n];\n\n/**\n * Additional tools only available in stdio mode (local execution)\n * These tools manage persistent configuration\n */\nexport const STDIO_ONLY_TOOLS: Tool[] = [\n  {\n    name: 'productive_configure',\n    description: 'Configure Productive.io credentials',\n    annotations: {\n      title: 'Configure Productive',\n      readOnlyHint: false,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\n    inputSchema: {\n      type: 'object',\n      properties: {\n        organizationId: { type: 'string' },\n        apiToken: { type: 'string' },\n        userId: { type: 'string' },\n      },\n      required: ['organizationId', 'apiToken'],\n    },\n  },\n  {\n    name: 'productive_get_config',\n    description: 'Get current configuration',\n    annotations: {\n      title: 'Get Productive Config',\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\n    inputSchema: {\n      type: 'object',\n      properties: {},\n    },\n  },\n];\n"],"names":[],"mappings":"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"}

package/dist/version-i2-GF6d1.js

@@ -0,0 +1,21 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname$1 = dirname(fileURLToPath(import.meta.url));
+function loadInstructions() {
+  try {
+    const skillPath = join(__dirname$1, "..", "skills", "SKILL.md");
+    const content = readFileSync(skillPath, "utf-8");
+    const withoutFrontmatter = content.replace(/^---\n[\s\S]*?\n---\n+/, "");
+    return withoutFrontmatter.trim();
+  } catch {
+    return "Productive.io MCP Server - Use the productive tool with resource and action parameters.";
+  }
+}
+const INSTRUCTIONS = loadInstructions();
+const VERSION = "0.8.0";
+export {
+  INSTRUCTIONS as I,
+  VERSION as V
+};
+//# sourceMappingURL=version-i2-GF6d1.js.map

package/dist/version-i2-GF6d1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-i2-GF6d1.js","sources":["../src/instructions.ts","../src/version.ts"],"sourcesContent":["/**\n * MCP Server Instructions\n *\n * These instructions are sent to Claude Desktop during initialization\n * and used as context/hints for the LLM. This ensures the AI agent\n * knows how to properly use the Productive.io MCP server.\n *\n * The content is derived from skills/SKILL.md (without YAML frontmatter).\n */\n\nimport { readFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\n/**\n * Load instructions from SKILL.md file\n * Removes YAML frontmatter (content between --- markers)\n */\nfunction loadInstructions(): string {\n  try {\n    // In dist/, go up to package root, then to skills/\n    const skillPath = join(__dirname, '..', 'skills', 'SKILL.md');\n    const content = readFileSync(skillPath, 'utf-8');\n\n    // Remove YAML frontmatter (between --- markers at start of file)\n    const withoutFrontmatter = content.replace(/^---\\n[\\s\\S]*?\\n---\\n+/, '');\n\n    return withoutFrontmatter.trim();\n  } catch {\n    // Fallback if file not found (shouldn't happen in production)\n    return 'Productive.io MCP Server - Use the productive tool with resource and action parameters.';\n  }\n}\n\nexport const INSTRUCTIONS = loadInstructions();\n","/**\n * Package version - injected from package.json at build time\n */\ndeclare const __VERSION__: string;\nexport const VERSION = __VERSION__;\n"],"names":["__dirname"],"mappings":";;;AAcA,MAAMA,cAAY,QAAQ,cAAc,YAAY,GAAG,CAAC;AAMxD,SAAS,mBAA2B;AAClC,MAAI;AAEF,UAAM,YAAY,KAAKA,aAAW,MAAM,UAAU,UAAU;AAC5D,UAAM,UAAU,aAAa,WAAW,OAAO;AAG/C,UAAM,qBAAqB,QAAQ,QAAQ,0BAA0B,EAAE;AAEvE,WAAO,mBAAmB,KAAA;AAAA,EAC5B,QAAQ;AAEN,WAAO;AAAA,EACT;AACF;AAEO,MAAM,eAAe,iBAAA;AChCrB,MAAM,UAAU;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@studiometa/productive-mcp",
-  "version": "0.6.4",
+  "version": "0.8.0",
   "description": "MCP server for Productive.io API - Model Context Protocol integration for Claude Desktop",
   "keywords": [
     "ai",
@@ -25,6 +25,7 @@
   },
   "files": [
     "dist",
+    "skills",
     "Dockerfile"
   ],
   "type": "module",
@@ -58,6 +59,14 @@
     "./handlers": {
       "types": "./dist/handlers.d.ts",
       "import": "./dist/handlers.js"
+    },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "import": "./dist/errors.js"
+    },
+    "./schema": {
+      "types": "./dist/schema.d.ts",
+      "import": "./dist/schema.js"
     }
   },
   "publishConfig": {
@@ -79,8 +88,9 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.4",
-    "@studiometa/productive-cli": "0.6.4",
-    "h3": "^1.15.1"
+    "@studiometa/productive-cli": "0.8.0",
+    "h3": "^1.15.1",
+    "zod": "4.3.6"
   },
   "devDependencies": {
     "@types/node": "^22.10.5",

package/skills/SKILL.md

@@ -0,0 +1,330 @@
+---
+name: productive-mcp
+description: MCP server for Productive.io - use with Claude Desktop or MCP-compatible clients for time tracking, projects, and tasks
+---
+
+# Productive MCP Server
+
+MCP (Model Context Protocol) server for Productive.io. Provides a single unified tool for all operations.
+
+## The `productive` Tool
+
+Single unified tool with this signature:
+
+```
+productive(resource, action, [parameters...])
+```
+
+### Resources & Actions
+
+| Resource    | Actions                                   | Description             |
+| ----------- | ----------------------------------------- | ----------------------- |
+| `projects`  | `list`, `get`, `help`                     | Project management      |
+| `time`      | `list`, `get`, `create`, `update`, `help` | Time tracking           |
+| `tasks`     | `list`, `get`, `create`, `update`, `help` | Task management         |
+| `services`  | `list`, `get`, `help`                     | Budget line items       |
+| `people`    | `list`, `get`, `me`, `help`               | Team members            |
+| `companies` | `list`, `get`, `create`, `update`, `help` | Client companies        |
+| `comments`  | `list`, `get`, `create`, `update`, `help` | Comments on tasks/deals |
+| `timers`    | `list`, `get`, `start`, `stop`, `help`    | Active timers           |
+| `deals`     | `list`, `get`, `create`, `update`, `help` | Sales deals             |
+| `bookings`  | `list`, `get`, `create`, `update`, `help` | Resource scheduling     |
+| `reports`   | `get`, `help`                             | Generate reports        |
+
+### Getting Help
+
+Use `action: "help"` to get detailed documentation for any resource:
+
+```json
+{
+  "resource": "time",
+  "action": "help"
+}
+```
+
+Returns filters, fields, includes, and examples for that resource.
+
+## Common Parameters
+
+| Parameter  | Type    | Description                                            |
+| ---------- | ------- | ------------------------------------------------------ |
+| `resource` | string  | **Required**. Resource type (see table above)          |
+| `action`   | string  | **Required**. Action to perform                        |
+| `id`       | string  | Resource ID (for `get`, `update`, `stop`)              |
+| `filter`   | object  | Filter criteria for `list` actions                     |
+| `page`     | number  | Page number (default: 1)                               |
+| `per_page` | number  | Items per page (default: 20, max: 200)                 |
+| `compact`  | boolean | Compact output (default: true for list, false for get) |
+| `include`  | array   | Related resources to include                           |
+| `query`    | string  | Text search on name/title fields                       |
+
+## Examples by Resource
+
+### Projects
+
+```json
+// List projects
+{ "resource": "projects", "action": "list" }
+
+// Search projects
+{ "resource": "projects", "action": "list", "query": "website" }
+
+// Get project details
+{ "resource": "projects", "action": "get", "id": "12345" }
+
+// Filter active projects
+{ "resource": "projects", "action": "list", "filter": { "archived": "false" } }
+```
+
+### Time Entries
+
+```json
+// List my time entries for a date range
+{
+  "resource": "time",
+  "action": "list",
+  "filter": {
+    "person_id": "me",
+    "after": "2024-01-15",
+    "before": "2024-01-21"
+  }
+}
+
+// Create time entry (time in MINUTES)
+{
+  "resource": "time",
+  "action": "create",
+  "service_id": "12345",
+  "date": "2024-01-16",
+  "time": 480,
+  "note": "Development work"
+}
+
+// Update time entry
+{
+  "resource": "time",
+  "action": "update",
+  "id": "67890",
+  "time": 240,
+  "note": "Updated note"
+}
+```
+
+### Tasks
+
+```json
+// List open tasks for a project
+{
+  "resource": "tasks",
+  "action": "list",
+  "filter": { "project_id": "12345", "status": "open" }
+}
+
+// Get task with comments
+{
+  "resource": "tasks",
+  "action": "get",
+  "id": "67890",
+  "include": ["comments", "assignee"]
+}
+
+// Search tasks
+{ "resource": "tasks", "action": "list", "query": "bug fix" }
+
+// Create task
+{
+  "resource": "tasks",
+  "action": "create",
+  "title": "New task",
+  "project_id": "12345",
+  "task_list_id": "111"
+}
+```
+
+### People
+
+```json
+// Get current user
+{ "resource": "people", "action": "me" }
+
+// List people
+{ "resource": "people", "action": "list" }
+
+// Search by name
+{ "resource": "people", "action": "list", "query": "john" }
+```
+
+### Services
+
+```json
+// List services for a project
+{
+  "resource": "services",
+  "action": "list",
+  "filter": { "project_id": "12345" }
+}
+```
+
+### Comments
+
+```json
+// List comments on a task
+{
+  "resource": "comments",
+  "action": "list",
+  "filter": { "task_id": "12345" }
+}
+
+// Add comment
+{
+  "resource": "comments",
+  "action": "create",
+  "task_id": "12345",
+  "body": "Looking good!"
+}
+```
+
+### Timers
+
+```json
+// List active timers
+{ "resource": "timers", "action": "list" }
+
+// Start timer on a service
+{ "resource": "timers", "action": "start", "service_id": "12345" }
+
+// Stop timer
+{ "resource": "timers", "action": "stop", "id": "67890" }
+```
+
+### Reports
+
+```json
+// Time report by person
+{
+  "resource": "reports",
+  "action": "get",
+  "report_type": "time_reports",
+  "group": "person",
+  "from": "2024-01-01",
+  "to": "2024-01-31"
+}
+
+// Budget report for a project
+{
+  "resource": "reports",
+  "action": "get",
+  "report_type": "budget_reports",
+  "filter": { "project_id": "12345" }
+}
+```
+
+## Filters Reference
+
+### Time Entries
+
+- `person_id` - Filter by person (use "me" for current user)
+- `project_id` - Filter by project
+- `service_id` - Filter by service
+- `after` - After date (YYYY-MM-DD)
+- `before` - Before date (YYYY-MM-DD)
+
+### Tasks
+
+- `project_id` - Filter by project
+- `assignee_id` - Filter by assigned person
+- `status` - Filter by status: `open`, `closed`, `all`
+- `task_list_id` - Filter by task list
+
+### Projects
+
+- `company_id` - Filter by company
+- `archived` - Include archived: `true`, `false`
+
+### Services
+
+- `project_id` - Filter by project
+- `deal_id` - Filter by deal
+
+### Bookings
+
+- `person_id` - Filter by person
+- `service_id` - Filter by service
+- `after` / `before` - Date range
+
+## Include (Related Resources)
+
+Fetch related data in a single request:
+
+```json
+{
+  "resource": "tasks",
+  "action": "get",
+  "id": "12345",
+  "include": ["project", "project.company", "assignee", "comments"]
+}
+```
+
+Common includes:
+
+- Tasks: `project`, `assignee`, `workflow_status`, `comments`, `subtasks`
+- Time entries: `person`, `service`, `project`
+- Deals: `company`, `deal_status`, `responsible`
+
+## Compact Mode
+
+- `compact: true` (default for `list`) - Returns minimal fields
+- `compact: false` (default for `get`) - Returns full details
+
+Force full details on list:
+
+```json
+{ "resource": "projects", "action": "list", "compact": false }
+```
+
+## Time Values
+
+**Time is always in MINUTES:**
+
+- 60 = 1 hour
+- 480 = 8 hours (full day)
+- 240 = 4 hours (half day)
+
+## Configuration Tools (stdio mode only)
+
+In local/stdio mode, additional configuration tools are available:
+
+```json
+// Configure credentials
+productive_configure({
+  "organizationId": "...",
+  "apiToken": "...",
+  "userId": "..."
+})
+
+// View current config (token masked)
+productive_get_config()
+```
+
+---
+
+## Best Practices for AI Agents
+
+**For data handling best practices, confirmation workflows, and error handling patterns, see the CLI skill documentation:**
+
+→ `@studiometa/productive-cli/skills/SKILL.md`
+
+Key points:
+
+1. **Never modify text content** - Use exact titles, descriptions, notes from API
+2. **Never invent IDs** - Always fetch first to get valid IDs
+3. **Always confirm before mutations** - Ask user before create/update/delete
+4. **Time is in minutes** - 480 = 8 hours
+
+### MCP-Specific Tips
+
+1. **Use `action: "help"`** - Get resource documentation before using unfamiliar resources
+2. **Use `compact: false`** for detailed single-item views
+3. **Use `include`** to reduce round-trips when you need related data
+4. **Use `query`** for text search instead of fetching all and filtering
+5. **Check `people.me`** first to get the current user's ID for filters