Procore MCP Server

by mohllal

347 downloads
Not rated
GitHub

About

The Procore MCP Server is a Model Context Protocol (MCP) server that connects LLMs to Procore APIs, enabling AI assistants to query and retrieve data from a Procore account. It is designed for developers and construction professionals who want to use natural language to interact…

Details

Author
mohllal
Downloads
347
Categories
Other

- Supports setting company and project context via procore_set_context
- Lists all accessible companies with procore_list_companies
- Retrieves company and project details
- Lists projects for a given company
- Lists submittals with optional filters
- Provides three prompts for generating summaries

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Procore MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install the server with uv sync, then create a .env file with your Procore API credentials (client ID, client secret, and redirect URI). Run python init_token.py to complete OAuth authentication and save a token to procore_token.json. Configure the server in Claude or VSCode by adding a JSON block that invokes uv run procore-mcp-server with the correct directory path.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "procore mcp server": {
            "procore-mcp-server": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

McpServers

{
    "procore-mcp-server": {
        "command": "uv",
        "args": [
            "sync"
        ]
    }
}

Procore MCP Server

A Model Context Protocol (MCP) server for Procore APIs, allowing LLMs to interact with Procore system.

Prerequisites

- Python 3.13+
- A Procore account with API access
- API credentials (client ID, client secret)

MCP Tools

The following tools are available:

- procore_set_context - Set the current company and/or project context.
- procore_list_companies - List all companies accessible to the authenticated user.
- procore_get_company_details - Get company details.
- procore_list_projects_for_company - List projects for a company.
- procore_get_project_details - Get project details.
- procore_list_submittals - List submittals for a project with optional filters.

MCP Prompts

The following prompts are available:

- company_summary - Generate a summary of a company's information.
- project_summary - Generate a summary of a project's information.
- submittals_summary - Generate a summary of submittals for a project.

Installation

1. Clone the repository
2. Install dependencies using uv:

uv sync

Configuration

1. Create a .env file in the root directory with your Procore API credentials:

PROCORE_CLIENT_ID=your_client_id
PROCORE_CLIENT_SECRET=your_client_secret
PROCORE_REDIRECT_URI=your_redirect_uri

Note: Use urn:ietf:wg:oauth:2.0:oob as the redirect URI for redirectless OAuth.

2. Initialize the authentication token:

python init_token.py

The script will guide you through the OAuth authentication process:

1. It will display an authorization URL
2. Open the URL in your browser and log in to Procore
3. After authorizing the application, you'll be shown an authorization code
4. Copy and paste this code back into the terminal prompt
5. The script will save your authentication token to procore_token.json

The MCP server will automatically use this token file for authentication with Procore APIs.

Usage

Claude Integration

Add the following JSON block to your Claude configuration file.

"mcpServers": {
  "mcp-procore": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/your/procore-mcp-server",
      "run",
      "procore-mcp-server",
    ]
  },
}

VSCode Integration

Add the following JSON block to your User Settings (JSON) file in VSCode.

"mcp": {
    "servers": {
      "mcp-procore": {
        "type": "stdio",
        "command": "uv",
        "args": [
          "--directory",
          "/path/to/your/procore-mcp-server",
          "run",
          "procore-mcp-server",
        ]
      },
  },
}

License

MIT

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.