Procore MCP Server
The Procore MCP Server exposes Procore's construction management REST API to AI assistants, enabling discovery, configuration, and execution of operations across 2,636+ endpoints covering project management, financials, workflows, and administration.
API Discovery & Execution
Browse API categories, discover and search all endpoints, and retrieve full parameter/response schemas
Execute any Procore REST API call (GET, POST, PUT, PATCH, DELETE) with support for pagination, path/query parameters, and request bodies
View auth status and set runtime configuration (e.g.,
company_id,project_id)
Workflow Management
List, create, get, restart, terminate, and bulk-create workflow instances (company & project level)
Manage workflow templates, versioned configurations, and presets
Manage assignees, workflow managers, and respond to or view history of workflow instances
Webhooks
List webhook resources and triggers at company and project levels
Create, delete, and bulk manage webhook triggers
Project Management
Submittals – List and filter project submittals
Specifications – Configure tools, manage areas, distribution groups and members
Punch List – Filter by assignee, creator, location, type, trade, ball-in-court, final approver, and more
Inspections – View and update inspection template item evidence configurations
Tasks – List distribution member options and defaults for task items
Project Dates – List project milestone and key dates
Project Directory – Bulk remove project memberships
Construction Financials
Prime Contracts – List, create, show, update, delete, and generate PDF exports
Requisitions – Update due dates for subcontractor invoices
Compliance – List, create, get, update, and delete requisition compliance documents and attachments
Units of Measure – Retrieve UOM master list configurations
Company Administration
Roles – List, create, update, delete, and reorder company roles
Support Pins – Fetch active support pins and create new ones
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 |
| List API categories with endpoint counts |
| List endpoints in a category |
| Full-text search across all endpoints |
| Get full parameter schema for an endpoint |
| Execute any Procore API call |
| Show current config and auth status |
| 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 installCopy the example env file and fill in your credentials:
cp .env.example .envPROCORE_CLIENT_ID=your_client_id
PROCORE_CLIENT_SECRET=your_client_secret
PROCORE_COMPANY_ID=your_company_idYou'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 buildAuthenticate with Procore (opens browser for OAuth):
npm run authStart the server:
npm startClaude 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
Build time:
scripts/generate-catalog.tsparses the 41MB Procore OpenAPI spec and produces a compactdata/catalog.jsonplus individual endpoint detail files indata/endpoint-details/.scripts/generate-tools-manifest.tsthen generates a tools manifest with one named MCP tool per API operation.Auth: Run
npm run authonce to complete the OAuth flow in your browser. Tokens are saved to~/.procore-mcp/tokens.jsonand auto-refresh when expired.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
Maintenance
Tools
- add_additional_assignees_to_a_workflow_instance_companyC
- add_additional_assignees_to_a_workflow_instance_projectC
- add_alternative_response_set_to_project_checklist_templateC
- add_a_new_markupC
- add_an_existing_response_to_an_item_response_setD
- add_attachments_to_punch_itemC
- add_category_to_projectB
- add_change_order_package_to_a_requisition_subcontractor_invoiceC
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/TylerIlunga/procore-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server