Integration · Projects & tasks

Connect Claude & ChatGPT to Finalcad

Ask your AI what is open on a construction project in Finalcad One. It can list observations and their comments, log a new observation, start a form from a template and record answers on it. It can also look up plans, documents, meetings, phases, trades, project members and the companies working on the project.

Connect Finalcad free

Free plan, no credit card. Takes about a minute.

Try asking

“Which observations are logged on the Harbour View project?”
The AI finds the project and lists its observations.
“Log an observation: missing fire sealing around the pipe in stairwell B.”
It creates the observation in the project with your description.
“Assign observation 3141 to the electrical trade.”
It looks up the project's trades and updates the observation with that trade.

What your AI can do

Observations

List, filter and read observations, create new ones, set their trade and read their comments.

Forms

List and read forms with their answers, start a form from a template, record answers and read comments.

Project information

Look up projects, workspaces, plans, documents, meetings, phases, trades, members and companies.

“Start a pre-pour inspection form for phase 2.”
It creates a new form in the project from the template and links it to the phase.
“What was said in the comments on the facade checklist?”
It finds the form and lists its comments.
“Which companies and people are on this project?”
It lists the companies working on the project and the project members.

197 tools for Finalcad

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

add_form_linkChanges dataLink a module (module id). API summary: Add form link.
add_membersChanges dataCreate a new company. API summary: Add members.
attach_form_answerChanges dataLink a form answer (project id). API summary: Link item to answer.
attach_form_answer_mediaChanges dataAttach a form answer (answer id). API summary: Link file to answer.
attach_forms_module_formChanges dataLink a forms module (module id). API summary: Add form template link.
attach_module_formsChanges dataLink a module (module id). API summary: Add form link.
attach_observation_mediaChanges dataAttach a observation (observation id). API summary: Add image observation.
create_authChanges dataCreate a new auth. API summary: Get user token.
create_categoryChanges dataCreate a new category for a module. API summary: Create category.
create_company_change_members_roleDeletesCreate a new change members role for a company. Destructive action; may require approval. API summary: Change role.
create_company_change_members_role_bulkMoves moneyCreate a new change members role bulk for a company. Required: body. Financial or irreversible action; may require approval. API summary: Change several roles.
create_company_datareferentialChanges dataCreate a new datareferential for a company. API summary: Create data referential.
create_company_membersChanges dataCreate a new company. API summary: Add members.
create_company_moduleChanges dataCreate a new module for a company. API summary: Create module.
create_company_userChanges dataCreate a new user for a company. API summary: Get members.
create_company_workspaceChanges dataCreate a new workspace for a company. API summary: Create workspace.
create_configChanges dataCreate a new config. API summary: Post datasets.
create_custom_report_for_formsChanges dataCreate a new generate. API summary: Create custom report for forms.
create_deleteChanges dataCreate a new delete. API summary: Delete module.
create_documentChanges dataCreate a new document. API summary: Upload medias.
create_filterChanges dataCreate a new filter. API summary: Get filtered observation IDs.
create_formChanges dataCreate a form in a project from a template. Pass `project_id`, `form_id` (the template), a `name` and optionally `phase_id`.
create_form_messageChanges dataCreate a new message for a form. Required: body. API summary: Add form instance comment.
create_forms_suggestionChanges dataCreate a new forms suggestion. API summary: Create form module by suggestion.
create_generateChanges dataCreate a new generate. API summary: Create forms unit export in PDF.
create_getChanges dataCreate a new get. API summary: Get forms unit export in PDF.
create_group_membersChanges dataCreate a new group. API summary: Add members to discussion group.
create_group_messageChanges dataCreate a new message for a group. Required: body. API summary: Add discussion group message.
create_media_uploadabortChanges dataCreate a new uploadabort for a media.
create_media_uploadappendChanges dataCreate a new uploadappend for a media.
create_media_uploadterminateChanges dataCreate a new uploadterminate for a media.
create_meetingChanges dataCreate a new meeting. API summary: Enable meeting module.
create_module_categoryChanges dataCreate a new category for a module. API summary: Create category.
create_observationChanges dataCreate an observation in a project. Pass `project_id`, a `description`, and optionally `module_id` and `group_id`.
create_observation_messageChanges dataCreate a new message for a observation. Required: body. API summary: Add observation comment.
create_observations_export_in_xlsxChanges dataCreate a new xl. API summary: Create observations export in XLSX.
create_projectChanges dataCreate a new project in your Finalcad organization with a `name`.
create_project_change_members_roleDeletesCreate a new change members role for a project. Destructive action; may require approval. API summary: Change role.
create_project_commonobservationChanges dataCreate a new commonobservation for a project. API summary: Create common observation.
create_project_companyChanges dataCreate a new company for a project. API summary: Create project companies.
create_project_documentChanges dataCreate a new document for a project. Required: body. API summary: Create document or folders.
create_project_folderChanges dataCreate a new folder for a project. API summary: Create folder.
create_project_form_answerChanges dataCreate a new form answer for a project. API summary: Create answer.
create_project_groupChanges dataCreate a new group for a project. API summary: Create discussion groups.
create_project_logoChanges dataCreate a new logo for a project. API summary: Add project logo.
create_project_meetingChanges dataCreate a new meeting for a project. Required: body. API summary: Add meeting.
create_project_moduleChanges dataCreate a new module for a project. API summary: Create observation module.
create_project_phaseChanges dataCreate a new phase for a project. API summary: Create phase.
create_project_planChanges dataCreate a new plan for a project. API summary: Create plans.
create_project_plansfromdocChanges dataCreate a new plansfromdoc for a project. API summary: Create plans from document.
create_project_tradeChanges dataCreate a new trade for a project. API summary: Create trade.
create_project_userChanges dataCreate a new user for a project. API summary: Add members to a project.
create_setChanges dataCreate a new set. API summary: Set organization form template custom report association.
create_suggestionChanges dataCreate a new suggestion. API summary: Create observation module based on suggestions.
create_uploadinitChanges dataCreate a new uploadinit.
create_webhookDeletesCreate a new webhook. Destructive action; may require approval. API summary: Create hook.
create_workspace_memberChanges dataCreate a new workspace. API summary: Add members.
create_workspace_moduleChanges dataCreate a new module for a workspace. API summary: Create module.
create_xlChanges dataCreate a new xl. API summary: Create forms export in XLSX.
delete_categoryDeletesPermanently delete a category by category id. Destructive action; may require approval. API summary: Delete category.
delete_company_common_observationsMoves moneyPermanently delete a common observation by organization id. Financial or irreversible action; may require approval. API summary: Delete organization common observations.
delete_company_datareferentialDeletesPermanently delete a datareferential by referential id. Destructive action; may require approval. API summary: Delete data referential.
delete_company_formsMoves moneyPermanently delete a form by organizationid. Financial or irreversible action; may require approval. API summary: Delete organization form template.
delete_company_membersDeletesPermanently delete a company by organization id. Destructive action; may require approval. API summary: Remove members.
delete_company_tradesMoves moneyPermanently delete a trade by organization id. Financial or irreversible action; may require approval. API summary: Delete organization trades.
delete_group_membersDeletesPermanently delete a group by group id. Destructive action; may require approval. API summary: Remove members to discussion group.
delete_moduleChanges dataCreate a new delete. API summary: Delete module.
delete_module_categoryDeletesPermanently delete a category by category id. Destructive action; may require approval. API summary: Delete category.
delete_projectDeletesPermanently delete a project by project id. Destructive action; may require approval.
delete_project_companiesMoves moneyPermanently delete a company by project id. Financial or irreversible action; may require approval. API summary: Delete project companies.
delete_project_documentDeletesPermanently delete a document by document id. Destructive action; may require approval. API summary: Delete document or folder.
delete_project_folderDeletesPermanently delete a folder by folder id. Destructive action; may require approval. API summary: Delete folder.
delete_project_form_answerDeletesPermanently delete a form answer by answer id. Destructive action; may require approval. API summary: Delete answer.
delete_project_logosMoves moneyPermanently delete a logo by project id. Financial or irreversible action; may require approval. API summary: Remove project logos.
delete_project_meetingDeletesPermanently delete a meeting by meeting id. Destructive action; may require approval. API summary: Delete meeting.
delete_project_membersDeletesPermanently delete a project by project id. Destructive action; may require approval. API summary: Remove members in a project.
delete_project_phaseDeletesPermanently delete a phase by phase id. Destructive action; may require approval. API summary: Delete phase.
delete_project_planDeletesPermanently delete a plan by plan id. Destructive action; may require approval. API summary: Delete plan.
delete_webhookDeletesPermanently delete a webhook by hook id. Destructive action; may require approval. API summary: Delete hook.
delete_workspace_formsMoves moneyPermanently delete a form by workspace id. Financial or irreversible action; may require approval. API summary: Delete workspace form template.
delete_workspace_memberDeletesPermanently delete a workspace by workspace id. Destructive action; may require approval. API summary: Remove members.
detach_form_answer_itemChanges dataUnlink a form answer (answer id). API summary: Unlink item to answer.
detach_form_answer_mediaChanges dataDetach a form answer (answer id). API summary: Unlink file to answer.
detach_forms_module_formChanges dataUnlink a forms module (module id). API summary: Remove form template link.
detach_module_formsChanges dataUnlink a module (module id). API summary: Remove form link.
get_companyGet one company by company id. API summary: Get hooks for the organization.
get_company_datareferentialGet one datareferential for a company by referential id. API summary: Get data referential.
get_company_formGet one form for a company by form id. API summary: Get form template.
get_company_workspaceGet one workspace for a company by workspace id. API summary: Get workspace.
get_current_userGet the profile of the Finalcad user whose API key is connected.
get_documentGet one document by `project_id` and `document_id`.
get_formGet one form in a project by `project_id` and `form_instance_id`.
get_form_form_instanceGet one form instance for a form by form instance id. API summary: Get form answers.
get_mediaGet one media by media id. API summary: Get media resource.
get_media_urlGet a download link for a media file (photo, attachment or document file) by `media_id`.
get_meetingGet one meeting by `project_id` and `meeting_id`.
get_meeting_2Get one meeting by module id. API summary: Get meeting module.
get_module_suggestionsList suggestions. API summary: Get module suggestions.
get_modules_suggestionsList suggestions. API summary: Get modules suggestions.
get_observationGet one observation by `project_id` and `observation_id`.
get_planGet one plan by `project_id` and `plan_id`.
get_projectGet one project by `project_id`.
get_project_commonobservationGet one commonobservation for a project by common obs id. API summary: Get project common observation.
get_project_companyGet one company for a project by company id. API summary: Get company info.
get_project_forms_moduleGet one forms module for a project by module id. API summary: Get form module.
get_project_groupGet one group for a project by group id. API summary: Get discussion group.
get_project_moduleGet one module for a project by module id. API summary: Get observation module.
get_project_statusGet the current status of a project by project id. API summary: Get project observation status.
get_project_tradeGet one trade for a project by trade id. API summary: Get project trade.
get_user_infoGet one user info by user id. API summary: Get user information.
get_webhookGet one webhook by hook id. API summary: Get hook.
list_children_foldersList children folders. API summary: Get folder content.
list_colorsList colors. API summary: Get module colors.
list_company_datareferentialsList datareferentials for a company. API summary: Get data referentials.
list_company_modulesList modules for a company. API summary: Get modules.
list_company_organization_rolesList organization roles for a company. API summary: Get roles.
list_company_prioritiesList priorities for a company. API summary: Get organization priorities library.
list_company_statusesList statuses for a company. API summary: Get organization observation status library.
list_company_tradesList trades for a company. API summary: Get organization trades and common observations.
list_configsList configs. API summary: Get datasets.
list_datasetsList datasets. API summary: Get dataset content.
list_dataseturlsList dataseturls. API summary: Get dataset URL.
list_differentialsList differentials. API summary: Get project forms differential.
list_documentsList the documents stored in a project by `project_id`.
list_filtersList filters. API summary: Get documents and folders by parent.
list_form_messagesList the messages posted on a form by `project_id` and `form_instance_id`.
list_form_statusesList statuses for a form. API summary: Get form templates statuses.
list_form_templatesList the form templates defined in your Finalcad organization. Use a template's ID as `form_id` when creating a form in a project.
list_formsList the forms (filled-in checklists and inspections) in a project by `project_id`.
list_geteventsList getevents. API summary: Get events list.
list_group_messagesList messages for a group. API summary: Get discussion group messages.
list_iconsList icons. API summary: Get module icons.
list_infosList infos. API summary: Get custom template association information.
list_languagesList languages. API summary: Get languages.
list_meetingsList the meetings in a project by `project_id`.
list_modulesList modules. API summary: Get project trades by module.
list_observation_messagesList the messages posted on an observation by `project_id` and `observation_id`.
list_observationsList the observations (site issues and remarks) in a project by `project_id`.
list_organizationsList the Finalcad organizations you belong to, with their IDs.
list_phasesList the phases of a project by `project_id`, for use as `phase_id` when creating forms.
list_plansList the plans (drawings) in a project by `project_id`.
list_productsList products. API summary: Get discussion groups for an item.
list_project_categoriesList categories for a project. API summary: Get form categories.
list_project_commonobservationsList commonobservations for a project. API summary: Get project common observations.
list_project_companiesList the companies (contractors and partners) working on a project by `project_id`.
list_project_foldersList folders for a project. API summary: Get folder tree.
list_project_forms_modulesList forms modules for a project. API summary: Get form modules.
list_project_forms_prioritiesList forms priorities for a project. API summary: Get project form priorities.
list_project_formsformsList formsforms for a project. API summary: Get project form templates.
list_project_groupsList groups for a project. API summary: Get discussion groups.
list_project_logosList logos for a project. API summary: Get project logos.
list_project_membersList the members of a project by `project_id`.
list_project_modulesList modules for a project. API summary: Get observation modules.
list_project_observations_prioritiesList observations priorities for a project. API summary: Get project observation priorities.
list_project_rolesList roles for a project. API summary: Get project roles.
list_projectsList the projects in your Finalcad organization. Use this to find a project ID.
list_status_next_statusesList next statuses for a status. API summary: Get project observation next status.
list_suggestionsList suggestions. API summary: Get module suggestions.
list_time_zonesList time zones. API summary: Get list of time zones.
list_trade_commonobservationsList commonobservations for a trade. API summary: Get project common observations by trade.
list_tradesList the trades in a project by `project_id`, for use as `trade_id` on observations.
list_workspace_formsList forms for a workspace. API summary: Get workspace form templates.
list_workspace_modulesList modules for a workspace. API summary: Get modules.
list_workspace_prioritiesList priorities for a workspace. API summary: Get workspace priorities library.
list_workspace_usersList users for a workspace. API summary: Get members.
list_workspacesList the workspaces in your Finalcad organization.
remove_form_linkChanges dataUnlink a module (module id). API summary: Remove form link.
remove_membersDeletesPermanently delete a company by company id. Destructive action; may require approval. API summary: Remove members.
restore_projectChanges dataRestore a project (project id).
set_workspace_form_template_custom_report_associationChanges dataCreate a new set. API summary: Set workspace form template custom report association.
update_company_common_observationsVisible to othersUpdate an existing common observation identified by organization id. Has effects visible outside this system. API summary: Add or update organization common observations.
update_company_moduleChanges dataUpdate an existing module identified by module id. API summary: Update module.
update_company_prioritiesVisible to othersUpdate an existing priority identified by organization id. Has effects visible outside this system. API summary: Update organization priorities library.
update_company_statusesVisible to othersUpdate an existing status identified by organization id. Has effects visible outside this system. API summary: Update organization observation status library.
update_company_tradesVisible to othersUpdate an existing trade identified by organization id. Has effects visible outside this system. API summary: Add or update organization trades.
update_company_workspaceChanges dataUpdate an existing workspace identified by workspace id. API summary: Update workspace.
update_datareferential_nameChanges dataUpdate an existing datareferential identified by referential id. API summary: Rename data referential.
update_datareferential_referentialChanges dataUpdate an existing datareferential identified by referential id. API summary: Update data referential.
update_meetingChanges dataUpdate an existing meeting identified by module id. API summary: Update meeting module.
update_module_categoryChanges dataUpdate an existing category identified by category id. API summary: Update category.
update_observationChanges dataChange an observation's trade (`trade_id`) or linked common observation (`common_observation_id`) by `project_id` and `observation_id`.
update_projectChanges dataRename a project by `project_id` with a new `name`, or set its picture with `media_id`.
update_project_companiesVisible to othersUpdate an existing company identified by project id. Has effects visible outside this system. API summary: Update project company name.
update_project_documentChanges dataUpdate an existing document identified by document id. API summary: Update document or folder.
update_project_folderChanges dataUpdate an existing folder identified by folder id. API summary: Update folder.
update_project_formChanges dataUpdate an existing form identified by form instance id. API summary: Update form.
update_project_form_answerChanges dataUpdate an existing form answer identified by answer id. API summary: Update answer.
update_project_forms_moduleChanges dataUpdate an existing forms module identified by module id. API summary: Update form module.
update_project_groupChanges dataUpdate an existing group identified by group id. API summary: Update discussion group.
update_project_meetingChanges dataUpdate an existing meeting identified by meeting id. API summary: Update meeting.
update_project_moduleChanges dataUpdate an existing module identified by module id. API summary: Modify observation module.
update_project_phaseChanges dataUpdate an existing phase identified by phase id. API summary: Update phase.
update_project_planChanges dataUpdate an existing plan identified by plan id. API summary: Update plan.
update_webhookDeletesUpdate an existing webhook identified by hook id. Destructive action; may require approval. API summary: Update hook.
update_workspace_moduleChanges dataUpdate an existing module identified by module id. API summary: Update module.
update_workspace_prioritiesVisible to othersUpdate an existing priority identified by workspace id. Has effects visible outside this system. API summary: Update workspace priorities library.
upload_plan_bimChanges dataUpload a plan (project id). API summary: Upload IFC.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Finalcad from the app list.
2
Paste your key
Paste your Finalcad API key in both fields, because Finalcad expects it in two headers. The Finalcad One API needs the Enterprise offer and a user who is administrator of at least one Enterprise organization. Log in to the Finalcad One web app, open the user menu and request an API key, then copy it. You can also add your organization ID.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Finalcad?

It can read your user profile, organizations, workspaces, projects, observations, forms, comments, meetings, documents, plans, phases, trades, project members and project companies, and get download links for photos and attachments. It can create and rename projects, create observations, update an observation's trade or linked common observation, start forms from a template and record answers on forms.

Does the AI see my Finalcad API key?

No. Your Finalcad API key is encrypted at rest and never shown to the AI. After you save it, it is not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start with lookups only. Creating observations, starting forms and recording answers can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Finalcad One account with API access.

Which Finalcad plan do I need?

The Finalcad One API needs the Enterprise offer, and the API key must come from a user who is administrator of at least one Enterprise organization. You request the key from the user menu in the Finalcad One web app and can revoke it there.