TylerIlunga/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
Copy the example env file and fill in your credentials:
By default the server exposes the **7 discovery tools**, and every Procore
endpoint is reached through procore_api_call. Registering a dedicated tool
per endpoint instead emits roughly 4.7 MB (~1.2M tokens) of tool definitions —
more than any current model's context window — so that surface is opt-in:
Coverage is identical in both modes; only the size of the advertised tool list
differs. If you switch to all and are migrating from before v2.0.0, see
data/tool-renames.json for the old -> new tool name map.
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 (~54MB). You can obtain it from Procore's API documentation.
Build the catalog and compile TypeScript:
Authenticate with Procore (opens browser for OAuth):
Start the server:
Claude Desktop configuration
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
Claude Code configuration
Add to .mcp.json in your project root:
Project structure
How it works
1. **Build time**: scripts/generate-catalog.ts parses the ~54MB Procore OpenAPI spec (3,155 operations) 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 — 2,929 in total, after collapsing older-version duplicates of the same path.
Each generated tool carries a structured description covering what it acts on, when to reach for it, which parent ids to resolve first, what it returns, and how it fails. Endpoints Procore has deprecated are registered with their sunset date in the description and a (Deprecated) title. The interactive /oauth/* endpoints are not registered as tools — npm run auth owns that flow — but remain reachable through procore_api_call.