Mattering Productivity API
Spaces, projects, tabs, widgets, tasks, batches, custom fields, presets, knowledge bases and query endpoints for the Productivity app.
https://productivity.mattering.io/api/user/v1/
Service tierhttps://productivity.mattering.io/api/internal/
53 MCP tools
Resources
62 endpoints, 54 on the User API, 8 service-only.
| Resource | Endpoints | Methods | Tiers |
|---|---|---|---|
| Attachments | 6 | POST | User API |
| Batch fields | 1 | POST | User API |
| Batches | 1 | POST | User API |
| Custom field presets | 2 | GETPOST | User API |
| Custom fields | 2 | GETPOST | User API |
| Folders | 1 | POST | User API |
| Knowledge bases | 2 | POST | User API |
| Notifications | 1 | POST | User API |
| Projects | 3 | GETPOST | User API |
| Queries | 4 | POST | User API |
| Recordings | 1 | POST | User API |
| Seed demo | 1 | POST | User API |
| Spaces | 4 | GET | User API |
| Status presets | 2 | GETPOST | User API |
| Tabs | 1 | POST | User API |
| Tasks | 16 | POST | User API |
| Templates | 1 | POST | User API |
| User spaces | 1 | GET | User API |
| Widgets | 5 | POST | User API |
| Workspace data | 1 | GET | User API |
Service tier only
These resources are reachable with the internal secret only. They are documented for operators and for anyone reading the MCP tools that wrap them.
| Resource | Endpoints | Methods |
|---|---|---|
| Org erasure | 1 | GET |
| Org export | 1 | GET |
| Search | 1 | GET |
| Usage | 1 | GET |
| User erasure | 1 | GET |
| User export | 1 | GET |
MCP tools
The Mattering MCP gateway exposes 53 tools for Productivity. Each wraps one of the endpoints above on the User API, forwarding your token.
See the Productivity MCP toolsShape against the shared standard
Mattering is converging every app on one API shape (the Base API Template). This is where Productivity stands, measured from its code. Read it before assuming the envelope on one app matches another.
| Yes | User tier mounted (/api/user/v1/) | |
| Not yet | Internal tier versioned (/api/internal/v1/) | |
| Not yet | One api_urls.py included on both tiers | |
| Not yet | Responses use the {data, meta} envelope | 0 of 62 endpoints |
| Not yet | Collection reads paginate with meta.total | 2 of 13 list endpoints paginate; hard caps on 44 |
| Not yet | Errors carry a snake_case code and a detail | 301 of 316 error returns use a stable code |
Unpaginated reads with a hard cap (results beyond the cap are not returned and no total is reported): batch-fields/update/ (8), custom-field-presets/manage/ (8), custom-fields/manage/ (8), folders/manage/ (8), kb/manage/ (8), notifications/send/ (8), projects/manage/ (8), projects/{project_id}/canvas/ (8), query/kb/ (8), query/task/ (8), search/ (8), seed-demo/ (8), spaces/ (8), spaces/{space_id}/custom-field-presets/list/ (8), spaces/{space_id}/members/ (8), spaces/{space_id}/overview/ (8), spaces/{space_id}/status-presets/list/ (8), status-presets/manage/ (8), tabs/manage/ (8), tasks/create-bulk/ (8), tasks/create-with-subtasks/ (8), tasks/create/ (8), tasks/delete-bulk/ (8), tasks/manage/ (8), tasks/serialize/{task_id}/ (8), tasks/update-bulk/ (8), tasks/{task_id}/assign/ (8), tasks/{task_id}/attachments/request-upload/ (12), tasks/{task_id}/attachments/upload/ (8), tasks/{task_id}/comment/ (8), tasks/{task_id}/custom-field/ (180), tasks/{task_id}/move/ (8), tasks/{task_id}/subtask/ (8), tasks/{task_id}/tags/add/ (8), tasks/{task_id}/tags/remove/ (8), tasks/{task_id}/update/ (8), templates/deploy/ (8), user-spaces/ (8), widgets/attach-backing-list/ (8), widgets/configure-view-bulk/ (8), widgets/configure-view/ (8), widgets/manage-bulk/ (8), widgets/manage/ (8), workspace-data/{space_id}/ (8).
Source: MatteringPMCore/api_urls.py, MatteringPMCore/urls.py. Regenerated by tools/build_api_docs.py.