The Procore connector lets your AI agent act in each user's Procore account. Each user signs in to Procore once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 27 tools.
- Tools
- 27
- What they doRead · write · destructive
- 16 · 10 · 116 read10 write1 destructive
- Users sign in with
- OAuth
- OAuth app
- Your own Procore app
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Procore connection
In AgentKit > Connections, create a Procore connection and copy its redirect URI. The name you give it is the
connection_nameyour code passes. See Configure connections.Register an OAuth app
Procore connections use your own OAuth app. Register one with Procore and add the redirect URI you copied.
Then enter the app's Client ID and Client Secret on the Procore connection.
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'procore'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Procore:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'procore_companies_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "procore"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Procore:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="procore_companies_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolprocore_companies_listList the Procore companies the connected user can access.Read-onlyList Companies
List the Procore companies the connected user can access. Returns an array of companies with id, name and is_active. Use procore_companies_list first: every other tool needs a company_id.
Inputs
pageinteger- Page number, starting at 1. Example: 2
per_pageinteger- Items per page (default 100). Example: 50
procore_me_getGet the Procore user the connection belongs to.Read-onlyGet Current User
Get the Procore user the connection belongs to. Returns id, login (email) and name. Use procore_me_get to confirm who is connected. Use procore_companies_list for the companies they can reach.
Inputs
This tool takes no inputs.
procore_notes_logs_listList the notes entries of a project's daily log.Read-onlyList Daily Log Notes
List the notes entries of a project's daily log. Returns an array of notes logs with id, date, comment, is_issue_day, location and created_by. Use procore_notes_logs_list to read daily log notes. Use procore_notes_log_create to add one.
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
created_by_idinteger- Only notes by this user. Example: 4521
pageinteger- Page number, starting at 1. Example: 2
per_pageinteger- Items per page (default 100). Example: 50
statusstring- pending, approved or all. Example: allone of
pendingapprovedall
procore_observation_getGet one observation item.Read-onlyGet Observation
Get one observation item. Returns the observation with number, name, description, status, priority, type, assignee, location, trade and dates. Use procore_observation_get when you know the observation ID.
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
observation_idintegerrequired- ID of the observation. Example: 12345
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
procore_observation_types_listList the observation types available in a project (such as Safety, Quality, Commissioning).Read-onlyList Observation Types
List the observation types available in a project (such as Safety, Quality, Commissioning). Returns an array of types with id, name and category. Use procore_observation_types_list to get the type_id for procore_observation_create.
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
pageinteger- Page number, starting at 1. Example: 2
per_pageinteger- Items per page (default 100). Example: 50
procore_observations_listList observation items (safety, quality and other field observations) on a project, filtered by type, status, assignee or a search.Read-onlyList Observations
List observation items (safety, quality and other field observations) on a project, filtered by type, status, assignee or a search. Returns an array of observations with id, number, name, status, priority, type, due_date, assignee and location. Use procore_observations_list to review field issues. Use procore_observation_get for one observation.
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
assignee_idinteger- Only observations assigned to this user. Example: 4521
pageinteger- Page number, starting at 1. Example: 2
per_pageinteger- Items per page (default 100). Example: 50
searchstring- Search text. Example: guardrail
statusinteger- Lifecycle status code: 0 Initiated, 1 Ready for Review, 2 Not Accepted, 3 Closed. Example: 0
type_idinteger- Observation type ID (from procore_observation_types_list). Example: 12
updated_atstring- Updated within an ISO 8601 range, written start...end. Example: 2026-11-01...2026-11-15
procore_project_getGet one project.Read-onlyGet Project
Get one project. Returns the project with id, name, project_number, address, dates, stage, type, office, owner and status fields. Use procore_project_get when you know the project ID.
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
procore_project_users_listList users in a project's directory, optionally searched by name or email.Read-onlyList Project Users
List users in a project's directory, optionally searched by name or email. Returns an array of users with id, name, email_address, job_title, vendor and permission template. Use procore_project_users_list to find user IDs for RFI managers, assignees and distribution lists.
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
employeeboolean- Only employees of your company (true) or only others (false). Example: true
pageinteger- Page number, starting at 1. Example: 2
per_pageinteger- Items per page (default 100). Example: 50
searchstring- Match first name, last name, email or company. Example: smith
procore_projects_listList projects in a company, filtered by status, name, project number or update time.Read-onlyList Projects
List projects in a company, filtered by status, name, project number or update time. Returns an array of projects with id, name, display_name, project_number, address, active, stage and dates. Use procore_projects_list to find a project_id. Use procore_project_get for one project.
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
namestring- Projects whose name matches this text. Example: Tower
pageinteger- Page number, starting at 1. Example: 2
per_pageinteger- Items per page (default 100). Example: 50
project_numberstring- Exact project number. Example: 2026-014
sortstring- name, display_name, project_number or status. Example: nameone of
namedisplay_nameproject_numberstatus statusstring- Active (default in the UI), Inactive or All. Example: Activeone of
AllActiveInactive updated_atstring- Updated within an ISO 8601 range, written start...end. Example: 2026-11-01...2026-11-15
procore_punch_item_getGet one punch item.Read-onlyGet Punch Item
Get one punch item. Returns the punch item with name, description, status, priority, due date, location, trade, assignments and attachments. Use procore_punch_item_get when you know the punch item ID.
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
punch_item_idintegerrequired- ID of the punch item. Example: 12345
procore_punch_items_listList punch items on a project, filtered by status, priority, vendor, assignee or a search.Read-onlyList Punch Items
List punch items on a project, filtered by status, priority, vendor, assignee or a search. Returns an array of punch items with id, position, name, status, priority, due_date, location, assignments and ball_in_court. Use procore_punch_items_list to review the punch list. Use procore_punch_item_get for one item.
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
pageinteger- Page number, starting at 1. Example: 2
per_pageinteger- Items per page (default 100). Example: 50
prioritystring- low, medium or high. Example: highone of
lowmediumhigh querystring- Search text. Example: drywall
statusstring- open, closed or pending. Example: openone of
openclosedpending updated_atstring- Updated within an ISO 8601 range, written start...end. Example: 2026-11-01...2026-11-15
vendor_idinteger- Only items assigned to this vendor. Example: 771
procore_rfi_getGet one RFI with its questions and responses.Read-onlyGet RFI
Get one RFI with its questions and responses. Returns the RFI with number, subject, status, questions[] (body, answers[]), assignees, rfi_manager, due_date and cost and schedule impact. Use procore_rfi_get to read an RFI's full thread.
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
rfi_idintegerrequired- ID of the RFI. Example: 12345
procore_rfis_listList RFIs on a project, filtered by status, ball in court, priority, overdue or a search on subject and number.Read-onlyList RFIs
List RFIs on a project, filtered by status, ball in court, priority, overdue or a search on subject and number. Returns an array of RFIs with id, number, subject, status, due_date, ball_in_court, rfi_manager and assignees. Use procore_rfis_list to track open questions. Use procore_rfi_get for the question and responses.
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
ball_in_court_idinteger- Only RFIs where this user is ball in court. Example: 4521
overdueboolean- Only overdue RFIs. Example: true
pageinteger- Page number, starting at 1. Example: 2
per_pageinteger- Items per page (default 100). Example: 50
searchstring- Search RFI subject or number. Example: kitchen
statusstring- open, closed, draft, closed_with_revision or closed_draft. Example: openone of
opencloseddraftclosed_with_revisionclosed_draft updated_atstring- Updated within an ISO 8601 range, written start...end. Example: 2026-11-01...2026-11-15
procore_submittal_getGet one submittal.Read-onlyGet Submittal
Get one submittal. Returns the submittal with number, revision, title, status, type, dates, approvers, ball_in_court and attachments. Use procore_submittal_get when you know the submittal ID.
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
submittal_idintegerrequired- ID of the submittal. Example: 12345
procore_submittals_listList submittals on a project, filtered by status, ball in court, spec section or a search, sorted and paged.Read-onlyList Submittals
List submittals on a project, filtered by status, ball in court, spec section or a search, sorted and paged. Returns an array of submittals with id, number, title, status, type, specification_section, due_date and ball_in_court. Use procore_submittals_list to track submittals. Use procore_submittal_get for one submittal.
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
ball_in_court_idinteger- Only submittals where this user is ball in court. Example: 4521
current_revisionboolean- Only current revisions. Example: true
pageinteger- Page number, starting at 1. Example: 2
per_pageinteger- Items per page (default 100). Example: 50
querystring- Search text. Example: storefront
sortstring- number, title, type, status, due_date or another documented sort field. Example: number
status_idinteger- Submittal status ID. Example: 1
updated_atstring- Updated within an ISO 8601 range, written start...end. Example: 2026-11-01...2026-11-15
procore_tasks_listList tasks (the project task tool) on a project, optionally searched.Read-onlyList Tasks
List tasks (the project task tool) on a project, optionally searched. Returns an array of tasks with id, number, title, status, due_date, assignees and category. Use procore_tasks_list to review project tasks.
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
pageinteger- Page number, starting at 1. Example: 2
per_pageinteger- Items per page (default 100). Example: 50
querystring- Search text. Example: inspection
updated_atstring- Updated within an ISO 8601 range, written start...end. Example: 2026-11-01...2026-11-15
procore_notes_log_createAdd a notes entry to a project's daily log.WriteCreate Daily Log Note
Add a notes entry to a project's daily log. Returns the created notes log with id. Use procore_notes_log_create to record site notes for a day.
Inputs
commentstringrequired- Note text. Example: Concrete pour delayed by rain
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
datestring- Log date (YYYY-MM-DD); defaults to today. Example: 2026-11-15
is_issue_dayboolean- Flag the note as an issue affecting the project. Example: true
location_idinteger- Location ID. Example: 9821
procore_observation_createCreate an observation item on a project.WriteCreate Observation
Create an observation item on a project. Returns the created observation with id and number. Use procore_observation_create to log a safety or quality issue. Get type_id from procore_observation_types_list.
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
namestringrequired- Short name. Example: Missing guardrail L3
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
type_idintegerrequired- Observation type ID. Example: 12
assignee_idinteger- User ID of the assignee (single-select assignee). Example: 4521
descriptionstring- Description. Example: Missing guardrail on level 3 east stair
due_datestring- Due date (YYYY-MM-DD). Example: 2026-11-20
location_idinteger- Location ID. Example: 9821
prioritystring- Low, Medium, High or Urgent. Example: Highone of
LowMediumHighUrgent trade_idinteger- Trade ID. Example: 55
procore_observation_updateUpdate an observation's name, type, description, priority, due date, assignee or location.WriteUpdate Observation
Update an observation's name, type, description, priority, due date, assignee or location. Returns the updated observation. Use procore_observation_update to change an observation; Procore requires name and type_id on every update.
- Idempotent
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
namestringrequired- Name (send the current one if unchanged). Example: Missing guardrail L3
observation_idintegerrequired- ID of the observation. Example: 12345
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
type_idintegerrequired- Type ID (send the current one if unchanged). Example: 12
assignee_idinteger- User ID of the assignee (single-select assignee). Example: 4521
descriptionstring- Description. Example: Missing guardrail on level 3 east stair
due_datestring- Due date (YYYY-MM-DD). Example: 2026-11-20
location_idinteger- Location ID. Example: 9821
prioritystring- Low, Medium, High or Urgent. Example: Highone of
LowMediumHighUrgent trade_idinteger- Trade ID. Example: 55
procore_punch_item_comment_createAdd a comment to a punch item's activity.WriteComment on Punch Item
Add a comment to a punch item's activity. Returns the created comment. Use procore_punch_item_comment_create to post an update on a punch item.
Inputs
bodystringrequired- Comment text. Example: Painter scheduled for Thursday
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
punch_item_idintegerrequired- ID of the punch item. Example: 12345
procore_punch_item_createCreate a punch item on a project, optionally assigned to users.WriteCreate Punch Item
Create a punch item on a project, optionally assigned to users. Returns the created punch item with id and position. Use procore_punch_item_create to log a deficiency. Use procore_punch_item_update to change or close it.
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
namestringrequired- Short name. Example: Drywall damage at C4
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
descriptionstring- Description. Example: Patch and repaint drywall at column C4
due_datestring- Due date (YYYY-MM-DD). Example: 2026-11-30
location_idinteger- Location ID. Example: 9821
login_information_idsarray- User IDs to assign. Example: [4521]
prioritystring- low, medium or high. Example: mediumone of
lowmediumhigh privateboolean- Mark private. Example: false
trade_idinteger- Trade ID. Example: 55
procore_punch_item_updateUpdate a punch item: rename it, change description, due date, priority, assignees or location, or close it.WriteUpdate Punch Item
Update a punch item: rename it, change description, due date, priority, assignees or location, or close it. Returns the updated punch item. Use procore_punch_item_update with status closed to close an item.
- Idempotent
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
namestringrequired- Name (Procore requires it on update; send the current name if unchanged). Example: Drywall damage at C4
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
punch_item_idintegerrequired- ID of the punch item. Example: 12345
descriptionstring- Description. Example: Patch and repaint drywall at column C4
due_datestring- Due date (YYYY-MM-DD). Example: 2026-11-30
location_idinteger- Location ID. Example: 9821
login_information_idsarray- User IDs to assign. Example: [4521]
prioritystring- low, medium or high. Example: mediumone of
lowmediumhigh privateboolean- Mark private. Example: false
statusstring- open or closed. Example: closedone of
openclosed trade_idinteger- Trade ID. Example: 55
procore_rfi_createCreate an RFI on a project with a subject, question and RFI manager; non-draft RFIs notify the assignees.WriteCreate RFI
Create an RFI on a project with a subject, question and RFI manager; non-draft RFIs notify the assignees. Returns the created RFI with id and number. Use procore_rfi_create to raise a question. Use procore_project_users_list to find user IDs.
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
questionstringrequired- The question text. Example: What color should the kitchen wall be?
rfi_manager_idintegerrequired- User ID of the RFI manager. Example: 4520
subjectstringrequired- RFI subject. Example: Kitchen wall paint color
assignee_idsarray- User IDs of the assignees. Example: [4521, 4522]
distribution_idsarray- User IDs on the distribution list. Example: [4523]
draftboolean- Save as a draft without notifying. Example: true
due_datestring- Due date (YYYY-MM-DD). Example: 2026-11-30
location_idinteger- Location ID. Example: 9821
privateboolean- Mark the RFI private. Example: false
referencestring- Reference text. Example: Detail 5/A-301
procore_rfi_updateUpdate an RFI's subject, assignees, due date, distribution or other fields, or close or reopen it with accepted.WriteUpdate RFI
Update an RFI's subject, assignees, due date, distribution or other fields, or close or reopen it with accepted. Returns the updated RFI. Use procore_rfi_update to change an RFI. Set accepted true to close it.
- Idempotent
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
rfi_idintegerrequired- ID of the RFI. Example: 12345
acceptedboolean- true closes the RFI, false reopens it. Example: true
assignee_idsarray- User IDs of the assignees. Example: [4521, 4522]
distribution_idsarray- User IDs on the distribution list. Example: [4523]
draftboolean- Save as a draft without notifying. Example: true
due_datestring- Due date (YYYY-MM-DD). Example: 2026-11-30
location_idinteger- Location ID. Example: 9821
privateboolean- Mark the RFI private. Example: false
referencestring- Reference text. Example: Detail 5/A-301
rfi_manager_idinteger- New RFI manager user ID. Example: 4520
subjectstring- New subject. Example: Kitchen wall paint color (revised)
procore_submittal_createCreate a submittal on a project.WriteCreate Submittal
Create a submittal on a project. Returns the created submittal with id. Use procore_submittal_create to log a new submittal. Use procore_submittal_update to change it.
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
numberstringrequired- Submittal number. Example: 08 41 13-1
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
descriptionstring- Description. Example: Aluminum storefront system
due_datestring- Due date (YYYY-MM-DD). Example: 2026-12-05
privateboolean- Mark private. Example: false
received_from_idinteger- User ID the submittal was received from. Example: 4521
responsible_contractor_idinteger- Vendor ID of the responsible contractor. Example: 771
specification_section_idinteger- Specification section ID. Example: 3312
submittal_manager_idinteger- User ID of the submittal manager (admins only). Example: 4520
titlestring- Title. Example: Storefront shop drawings
typestring- Submittal type name, as configured on the project. Example: Shop Drawing
procore_submittal_updateUpdate a submittal's title, type, spec section, contractor, manager, due date or other fields.WriteUpdate Submittal
Update a submittal's title, type, spec section, contractor, manager, due date or other fields. Returns the updated submittal. Use procore_submittal_update to change a submittal.
- Idempotent
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
numberstringrequired- Submittal number (Procore requires it on update; send the current number if unchanged). Example: 08 41 13-1
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
submittal_idintegerrequired- ID of the submittal. Example: 12345
descriptionstring- Description. Example: Aluminum storefront system
due_datestring- Due date (YYYY-MM-DD). Example: 2026-12-05
privateboolean- Mark private. Example: false
received_from_idinteger- User ID the submittal was received from. Example: 4521
responsible_contractor_idinteger- Vendor ID of the responsible contractor. Example: 771
specification_section_idinteger- Specification section ID. Example: 3312
status_idinteger- New status ID (admins only). Example: 2
submittal_manager_idinteger- User ID of the submittal manager (admins only). Example: 4520
titlestring- Title. Example: Storefront shop drawings
typestring- Submittal type name, as configured on the project. Example: Shop Drawing
procore_punch_item_deleteDelete a punch item (it moves to the project's recycle bin).DestructiveDelete Punch Item
Delete a punch item (it moves to the project's recycle bin). Returns an empty response on success. Use procore_punch_item_delete to remove an item logged by mistake; close it with procore_punch_item_update otherwise.
- Idempotent
Inputs
company_idintegerrequired- Procore company ID, sent as the Procore-Company-Id header (from procore_companies_list). Example: 8089
project_idintegerrequired- Project ID (from procore_projects_list). Example: 2783
punch_item_idintegerrequired- ID of the punch item. Example: 12345
No tools match.