procore-mcp-server

Procore MCP Server


MCP server that exposes the full Procore REST API to AI assistants like Claude. Built with TypeScript and the Model Context Protocol SDK.

Works with Claude Desktop, Claude Code, and any MCP-compatible client.

What it does

A build-time parser converts Procore's OpenAPI spec into a compact catalog, then auto-generates individual MCP tools for every API operation. At runtime, 7 meta-tools let the AI discover and call any Procore endpoint:

| Tool | Purpose | |------|---------| | procore_discover_categories | List API categories with endpoint counts | | procore_discover_endpoints | List endpoints in a category | | procore_search_endpoints | Full-text search across all endpoints | | procore_get_endpoint_details | Get full parameter schema for an endpoint | | procore_api_call | Execute any Procore API call | | procore_get_config | Show current config and auth status | | procore_set_config | Set runtime config (company_id, project_id) |

Prerequisites

• Node.js 18+
• A Procore Developer Portal account
• An OAuth app with Authorization Code grant type
• Set your redirect URI to http://localhost

Setup

git clone https://github.com/TylerIlunga/procore-mcp-server.git
cd procore-mcp-server
npm install

Copy the example env file and fill in your credentials:

cp .env.example .env

PROCORE_CLIENT_ID=your_client_id
PROCORE_CLIENT_SECRET=your_client_secret
PROCORE_COMPANY_ID=your_company_id

You'll need Procore's OpenAPI spec file placed at specs/combined_OAS.json. This file is not included in the repo due to its size (~41MB). You can obtain it from Procore's API documentation.

Build the catalog and compile TypeScript:

npm run build

Authenticate with Procore (opens browser for OAuth):

npm run auth

Start the server:

npm start

Claude Desktop configuration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "procore": {
      "command": "node",
      "args": ["/absolute/path/to/procore-mcp-server/dist/src/index.js"],
      "env": {
        "PROCORE_CLIENT_ID": "your_client_id",
        "PROCORE_CLIENT_SECRET": "your_client_secret",
        "PROCORE_COMPANY_ID": "your_company_id"
      }
    }
  }
}

Claude Code configuration

Add to .mcp.json in your project root:

{
  "mcpServers": {
    "procore": {
      "command": "node",
      "args": ["/absolute/path/to/procore-mcp-server/dist/src/index.js"],
      "env": {
        "PROCORE_CLIENT_ID": "your_client_id",
        "PROCORE_CLIENT_SECRET": "your_client_secret",
        "PROCORE_COMPANY_ID": "your_company_id"
      }
    }
  }
}

Project structure

src/
  auth/       OAuth token exchange, refresh, storage
  api/        HTTP client with auth, rate limits, retries
  catalog/    Endpoint catalog loading, search, filtering
  tools/      MCP tool handlers and registration
scripts/
  generate-catalog.ts          Parse OAS into catalog
  generate-tools-manifest.ts   Generate per-endpoint MCP tools
  validate-catalog.ts          Validate catalog integrity
data/         Build output (gitignored): catalog.json, endpoint details
specs/        Source OAS file (gitignored)

How it works

1. Build time: scripts/generate-catalog.ts parses the 41MB Procore OpenAPI spec and produces a compact data/catalog.json plus individual endpoint detail files in data/endpoint-details/. scripts/generate-tools-manifest.ts then generates a tools manifest with one named MCP tool per API operation.

1. Auth: Run npm run auth once to complete the OAuth flow in your browser. Tokens are saved to ~/.procore-mcp/tokens.json and auto-refresh when expired.

1. Runtime: The MCP server loads the catalog and registers all tools. When an AI assistant calls a tool, the server maps it to the correct Procore API endpoint, injects auth headers, handles rate limits and pagination, and returns the response.

Inspiration

Built to help my girlfriend, a construction engineer who uses Procore daily.

License

MIT