Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Procore

Scalekit connector
Open markdown

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 app
Your own Procore app

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. 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>
  3. Create the Procore connection

    In AgentKit > Connections, create a Procore connection and copy its redirect URI. The name you give it is the connection_name your code passes. See Configure connections.

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

  5. 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.actions
    const connector = 'procore'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { 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 call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'procore_companies_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • procore_companies_listList the Procore companies the connected user can access.Read-only

    List 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-only

    Get 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-only

    List 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-only

    Get 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-only

    List 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-only

    List 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-only

    Get 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-only

    List 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