Fieldwire MCP by usefulapi
Server Details
Read Fieldwire projects, tasks, plans, forms, RFIs and submittals; create and update tasks.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP ยท MCP 2025-06-18
- URL
- Repository
- m190/usefulapi-mcp
- GitHub Stars
- 0
TDQS
Score is being calculated.
Available Tools
22 toolsfieldwire_create_taskCreate taskInspect
WRITE: creates a new task in a project. It is sent once and never retried; if the reply is an error, check fieldwire_list_tasks before creating it again, or you may get a duplicate. owner_user_id and priority are required; creator_user_id defaults to the owner. Find user ids with fieldwire_list_project_users. POST /api/v3/projects/{project_id}/tasks.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Task name. | |
| end_at | No | End, ISO 8601 date-time with a timezone. | |
| team_id | No | Team (category) id - see fieldwire_list_teams. | |
| due_date | No | Due date, yyyy-mm-dd. | |
| priority | Yes | Priority 1, 2 or 3 (Fieldwire's own values; required). | |
| start_at | No | Start, ISO 8601 date-time with a timezone. | |
| user_ids | No | User ids of the assignees. On an update this REPLACES the whole assignee list. | |
| status_id | No | Status id - see fieldwire_list_task_statuses. | |
| cost_value | No | Cost of the task. | |
| project_id | Yes | Fieldwire project id (UUID) - see fieldwire_list_projects. | |
| location_id | No | Location id - see fieldwire_list_locations. | |
| floorplan_id | No | Plan (floorplan) id the task belongs to - see fieldwire_list_floorplans. | |
| owner_user_id | Yes | User id of the task owner (required) - see fieldwire_list_project_users. | |
| creator_user_id | No | User id recorded as creator (default: the owner). | |
| man_power_value | No | Estimated man-power (hours, days or months as set in the project). |
fieldwire_get_accountGet accountRead-onlyInspect
The Fieldwire account this API token belongs to: id, company name and address, enabled modules (submittals, change orders, RFIs, specs, BIM) and the owner. GET /account on the account host.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
fieldwire_get_formGet formRead-onlyInspect
One form by id (header data only, not the filled-in values). GET /api/v3/projects/{project_id}/forms/{id}.
| Name | Required | Description | Default |
|---|---|---|---|
| form_id | Yes | Form id (UUID). | |
| project_id | Yes | Fieldwire project id (UUID) - see fieldwire_list_projects. |
fieldwire_get_form_fullGet form with all valuesRead-onlyInspect
A form with its sections, inputs and filled-in values. Two steps: call without jid to start the job (Fieldwire answers with a jid); then call again with that jid until the form comes back (answer 'pending' means not ready, retry). GET /api/v3/projects/{project_id}/forms/{id}/full.
| Name | Required | Description | Default |
|---|---|---|---|
| jid | No | The jid returned by the first call; leave out to start. | |
| form_id | Yes | Form id (UUID). | |
| project_id | Yes | Fieldwire project id (UUID) - see fieldwire_list_projects. |
fieldwire_get_projectGet projectRead-onlyInspect
One project by id: name, code, address, time zone, currency, plan, enabled features and owner email. GET /api/v3/projects/{id}.
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | Fieldwire project id (UUID) - see fieldwire_list_projects. |
fieldwire_get_taskGet taskRead-onlyInspect
One task by id with all its fields. GET /api/v3/projects/{project_id}/tasks/{id}.
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | Task id (UUID). | |
| project_id | Yes | Fieldwire project id (UUID) - see fieldwire_list_projects. |
fieldwire_list_account_usersList account usersRead-onlyInspect
All users on the account (and users invited to its projects) with name, company, email, account role and the number of projects each is in. User ids are what tasks use for owner and assignees. GET /account/users on the account host.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
fieldwire_list_attachmentsList attachmentsRead-onlyInspect
Files, photos, videos and 360 photos attached in a project: id, name, kind, size, capture time and file URLs. Filter by kind. GET /api/v3/projects/{project_id}/attachments.
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Only these kinds. | |
| state | No | Only active records (the usual) or only deleted ones. Sent as the Fieldwire-Filter header. | |
| per_page | No | Results per page, 1-200 (default 25). | |
| project_id | Yes | Fieldwire project id (UUID) - see fieldwire_list_projects. | |
| last_synced_at | No | Cursor for the next page: the previous reply's next_last_synced_at, unchanged. Leave out for the first page. |
fieldwire_list_floorplansList plans (floorplans)Read-onlyInspect
Plans (floorplans) of a project: id, name, description, folder and sheet count. Filter by name, tag or dates. Set with_current_sheet to include each plan's current sheet. GET /api/v3/projects/{project_id}/floorplans.
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Only plans with exactly this tag. | |
| state | No | Only active records (the usual) or only deleted ones. Sent as the Fieldwire-Filter header. | |
| per_page | No | Results per page, 1-200 (default 25). | |
| project_id | Yes | Fieldwire project id (UUID) - see fieldwire_list_projects. | |
| name_contains | No | Only plans whose name contains this text. | |
| updated_after | No | Only plans updated at or after this ISO 8601 date-time. | |
| last_synced_at | No | Cursor for the next page: the previous reply's next_last_synced_at, unchanged. Leave out for the first page. | |
| with_current_sheet | No | Include the current sheet of each plan. |
fieldwire_list_formsList formsRead-onlyInspect
Forms (inspections, daily reports, checklists) of a project: id, name, template, status, owner, dates. Forms need a Business plan. Use fieldwire_get_form_full for the filled-in values. GET /api/v3/projects/{project_id}/forms.
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | Only active records (the usual) or only deleted ones. Sent as the Fieldwire-Filter header. | |
| per_page | No | Results per page, 1-200 (default 25). | |
| due_after | No | Only forms due on or after this date or date-time. | |
| due_before | No | Only forms due on or before this date or date-time. | |
| project_id | Yes | Fieldwire project id (UUID) - see fieldwire_list_projects. | |
| name_contains | No | Only forms whose name contains this text. | |
| owner_user_id | No | Only forms owned by this user id. | |
| updated_after | No | Only forms updated at or after this ISO 8601 date-time. | |
| last_synced_at | No | Cursor for the next page: the previous reply's next_last_synced_at, unchanged. Leave out for the first page. | |
| form_template_id | No | Only forms made from this template (see fieldwire_list_form_templates). |
fieldwire_list_form_templatesList form templatesRead-onlyInspect
Form templates of a project: id, name, version, publish state. Use the id to filter forms. GET /api/v3/projects/{project_id}/form_templates.
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | Only active records (the usual) or only deleted ones. Sent as the Fieldwire-Filter header. | |
| per_page | No | Results per page, 1-200 (default 25). | |
| project_id | Yes | Fieldwire project id (UUID) - see fieldwire_list_projects. | |
| name_contains | No | Only templates whose name contains this text. | |
| last_synced_at | No | Cursor for the next page: the previous reply's next_last_synced_at, unchanged. Leave out for the first page. |
fieldwire_list_locationsList locationsRead-onlyInspect
Locations of a project (id, name, parent location_id). Tasks carry a location_id. GET /api/v3/projects/{project_id}/locations.
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | Only active records (the usual) or only deleted ones. Sent as the Fieldwire-Filter header. | |
| per_page | No | Results per page, 1-200 (default 25). | |
| project_id | Yes | Fieldwire project id (UUID) - see fieldwire_list_projects. | |
| last_synced_at | No | Cursor for the next page: the previous reply's next_last_synced_at, unchanged. Leave out for the first page. |
fieldwire_list_projectsList projectsRead-onlyInspect
Projects the token's user can access in the region chosen at login: id, name, code, address, time zone, plan and archive state. Filter by name, code, archive state or update time. Use the id in every other tool. GET /api/v3/projects.
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | Only the project with this exact project code. | |
| state | No | Only active records (the usual) or only deleted ones. Sent as the Fieldwire-Filter header. | |
| archived | No | true = only archived projects, false = only unarchived. | |
| per_page | No | Results per page, 1-200 (default 25). | |
| name_contains | No | Only projects whose name contains this text. | |
| updated_after | No | Only projects updated at or after this ISO 8601 date-time. | |
| last_synced_at | No | Cursor for the next page: the previous reply's next_last_synced_at, unchanged. Leave out for the first page. | |
| updated_before | No | Only projects updated at or before this ISO 8601 date-time. |
fieldwire_list_project_usersList project usersRead-onlyInspect
Users on one project with name, company, job title, email and phone. The integer id is what tasks use for owner_user_id and user_ids. Filter by email, name or company. GET /api/v3/account/projects/{project_id}/users.
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | Fieldwire project id (UUID) - see fieldwire_list_projects. | |
| email_contains | No | Only users whose email contains this text. | |
| company_contains | No | ||
| last_name_contains | No | ||
| first_name_contains | No |
fieldwire_list_rfisList RFIsRead-onlyInspect
RFIs (requests for information) of a project: number, name, question, answer, status, assignee, due date. Needs the RFI module. Filter by status, assignee, text, overdue or dates. GET /api/v3/projects/{project_id}/rfis.
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | Free-text search. | |
| state | No | Only active records (the usual) or only deleted ones. Sent as the Fieldwire-Filter header. | |
| status | No | Only RFIs with this status. | |
| overdue | No | true = only overdue RFIs. | |
| per_page | No | Results per page, 1-200 (default 25). | |
| project_id | Yes | Fieldwire project id (UUID) - see fieldwire_list_projects. | |
| updated_after | No | Only RFIs updated at or after this ISO 8601 date-time. | |
| last_synced_at | No | Cursor for the next page: the previous reply's next_last_synced_at, unchanged. Leave out for the first page. | |
| assignee_user_id | No | Only RFIs assigned to this user id. |
fieldwire_list_sheetsList sheetsRead-onlyInspect
Sheets (plan versions) of a project: id, name, file name, version, floorplan_id and file URLs. Filter by plan, folder, name or dates. GET /api/v3/projects/{project_id}/sheets.
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | Only active records (the usual) or only deleted ones. Sent as the Fieldwire-Filter header. | |
| per_page | No | Results per page, 1-200 (default 25). | |
| folder_id | No | Only sheets in this folder. | |
| project_id | Yes | Fieldwire project id (UUID) - see fieldwire_list_projects. | |
| floorplan_id | No | Only sheets of this plan. | |
| name_contains | No | Only sheets whose name contains this text. | |
| updated_after | No | Only sheets updated at or after this ISO 8601 date-time. | |
| last_synced_at | No | Cursor for the next page: the previous reply's next_last_synced_at, unchanged. Leave out for the first page. |
fieldwire_list_submittalsList submittalsRead-onlyInspect
Submittals of a project: number, name, status, revision, key dates. Needs the submittals module. Filter by status, assignee, text, overdue or dates. GET /api/v3/projects/{project_id}/submittals.
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | Free-text search. | |
| state | No | Only active records (the usual) or only deleted ones. Sent as the Fieldwire-Filter header. | |
| status | No | Only submittals with this status. | |
| overdue | No | true = only overdue submittals. | |
| per_page | No | Results per page, 1-200 (default 25). | |
| project_id | Yes | Fieldwire project id (UUID) - see fieldwire_list_projects. | |
| updated_after | No | Only submittals updated at or after this ISO 8601 date-time. | |
| last_synced_at | No | Cursor for the next page: the previous reply's next_last_synced_at, unchanged. Leave out for the first page. | |
| assignee_user_id | No | Only submittals assigned to this user id. |
fieldwire_list_task_check_itemsList task checklist itemsRead-onlyInspect
Checklist items of all tasks in a project: name, checked flag, state (empty/yes/no/not_applicable) and task_id (match it to the task). GET /api/v3/projects/{project_id}/task_check_items.
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | Only active records (the usual) or only deleted ones. Sent as the Fieldwire-Filter header. | |
| per_page | No | Results per page, 1-200 (default 25). | |
| project_id | Yes | Fieldwire project id (UUID) - see fieldwire_list_projects. | |
| last_synced_at | No | Cursor for the next page: the previous reply's next_last_synced_at, unchanged. Leave out for the first page. |
fieldwire_list_tasksList tasksRead-onlyInspect
Tasks (punch items, issues) in a project: name, status_id, team_id, location_id, floorplan_id, owner and assignee user ids, priority, dates and cost. Filter by status, team, location, plan, owner, name, tag and dates. Resolve ids with fieldwire_list_task_statuses, _list_teams, _list_locations and _list_project_users. GET /api/v3/projects/{project_id}/tasks.
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Only tasks with exactly this tag. | |
| state | No | Only active records (the usual) or only deleted ones. Sent as the Fieldwire-Filter header. | |
| team_id | No | Only tasks of this team (shown as 'category' in the Fieldwire app). | |
| per_page | No | Results per page, 1-200 (default 25). | |
| due_after | No | Only tasks due on or after this date (yyyy-mm-dd) or date-time. | |
| status_id | No | Only tasks with this status id. | |
| due_before | No | Only tasks due on or before this date (yyyy-mm-dd) or date-time. | |
| project_id | Yes | Fieldwire project id (UUID) - see fieldwire_list_projects. | |
| location_id | No | Only tasks at this location. | |
| floorplan_id | No | Only tasks pinned on this plan (floorplan). | |
| created_after | No | Only tasks created at or after this ISO 8601 date-time. | |
| name_contains | No | Only tasks whose name contains this text. | |
| owner_user_id | No | Only tasks owned by this user id. | |
| updated_after | No | Only tasks updated at or after this ISO 8601 date-time. | |
| created_before | No | Only tasks created at or before this ISO 8601 date-time. | |
| last_synced_at | No | Cursor for the next page: the previous reply's next_last_synced_at, unchanged. Leave out for the first page. | |
| updated_before | No | Only tasks updated at or before this ISO 8601 date-time. | |
| creator_user_id | No | Only tasks created by this user id. |
fieldwire_list_task_statusesList task statusesRead-onlyInspect
The task statuses of a project (id, name, order, kind open/tracked/verified, default flag). Use the id as status_id on tasks. GET /api/v3/projects/{project_id}/statuses.
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | Fieldwire project id (UUID) - see fieldwire_list_projects. |
fieldwire_list_teamsList teams (task categories)Read-onlyInspect
Teams of a project (id, name, handle). The Fieldwire app calls them 'categories' on tasks; tasks carry a team_id. GET /api/v3/projects/{project_id}/teams.
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | Only active records (the usual) or only deleted ones. Sent as the Fieldwire-Filter header. | |
| per_page | No | Results per page, 1-200 (default 25). | |
| project_id | Yes | Fieldwire project id (UUID) - see fieldwire_list_projects. | |
| last_synced_at | No | Cursor for the next page: the previous reply's next_last_synced_at, unchanged. Leave out for the first page. |
fieldwire_update_taskUpdate taskDestructiveInspect
WRITE: changes fields of one task (only the fields you pass; user_ids replaces the whole assignee list; null clears a field that allows it). Use it to set the status, owner, assignees, priority or dates. It does not delete the task. Sent once, never retried. PATCH /api/v3/projects/{project_id}/tasks/{id}.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Task name; null removes it. | |
| end_at | No | End, ISO 8601 date-time with a timezone; null removes it. | |
| task_id | Yes | Task id (UUID). | |
| team_id | No | Team (category) id; null removes the team. | |
| due_date | No | Due date, yyyy-mm-dd; null removes the due date. | |
| priority | No | Priority 1, 2 or 3 (Fieldwire's own values). | |
| start_at | No | Start, ISO 8601 date-time with a timezone; null removes it. | |
| user_ids | No | User ids of the assignees. REPLACES the whole assignee list; null removes all assignees. | |
| status_id | No | Status id - see fieldwire_list_task_statuses; null removes the status. | |
| cost_value | No | Cost of the task; null removes it. | |
| project_id | Yes | Fieldwire project id (UUID) - see fieldwire_list_projects. | |
| location_id | No | Location id; null removes the location. | |
| floorplan_id | No | Plan (floorplan) id; null removes the plan. | |
| owner_user_id | No | User id of the task owner - see fieldwire_list_project_users. | |
| man_power_value | No | Estimated man-power; null removes it. |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
22 tool updates
- First observed
fieldwire_create_task - First observed
fieldwire_get_account - First observed
fieldwire_get_form - First observed
fieldwire_get_form_full - First observed
fieldwire_get_project - First observed
fieldwire_get_task - First observed
fieldwire_list_account_users - First observed
fieldwire_list_attachments - First observed
fieldwire_list_floorplans - First observed
fieldwire_list_form_templates - First observed
fieldwire_list_forms - First observed
fieldwire_list_locations - First observed
fieldwire_list_project_users - First observed
fieldwire_list_projects - First observed
fieldwire_list_rfis - First observed
fieldwire_list_sheets - First observed
fieldwire_list_submittals - First observed
fieldwire_list_task_check_items - First observed
fieldwire_list_task_statuses - First observed
fieldwire_list_tasks - First observed
fieldwire_list_teams - First observed
fieldwire_update_task
Related MCP Connectors
Read teams, spaces, lists and tasks; create, update and comment on tasks and track time.
Read Buildium properties, units, leases, tenants, balances and bills; manage work orders.
Read Synchroteam jobs, customers, sites, equipment and parts; create, schedule and complete jobs.
331Read tasks, habits, events and scheduling links; create and update Reclaim tasks and habits.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAutodesk Construction Cloud integration via APS โ Manage projects, issues, RFIs, documents, and submittals.-
- AlicenseNot gradedqualityBmaintenanceEnables Claude Code to read and update tasks in the Nexus/TaskBridge project management system through its public API.74 npmISC
- FlicenseCqualityDmaintenanceEnables AI assistants to manage Trackfusion projects and tasks, including listing, creating, updating, and filtering tasks.761-
- FlicenseNot gradedqualityDmaintenanceIntegrates with Freelo project management API to retrieve task details, list subtasks with completion status, and download files from task comments.7 npm-
Glama MCP Gateway
Add one secure layer between your agents and this server.