Menu

Mattering Productivity API

Spaces, projects, tabs, widgets, tasks, batches, custom fields, presets, knowledge bases and query endpoints for the Productivity app.

User APIhttps://productivity.mattering.io/api/user/v1/ Service tierhttps://productivity.mattering.io/api/internal/ 53 MCP tools
Most responses are bare dictionaries, not the {data, meta} envelope. Collection reads return the collection key plus count, and mutations return success plus the affected object.
Every endpoint, including reads, is POST with a JSON body. Pass space_id, project_id or widget_id in the body, never as a query string.
Identity guard: a body user_id that disagrees with the token subject is rejected.

Resources

62 endpoints, 54 on the User API, 8 service-only.

ResourceEndpointsMethodsTiers
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.

ResourceEndpointsMethods
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 tools

Shape 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.

Start Free Explore our Products