Procore MCP Server
Procore MCP Server
MCP-сервер, который предоставляет полный REST API Procore ИИ-ассистентам, таким как Claude. Создан на TypeScript и Model Context Protocol SDK.
Работает с Claude Desktop, Claude Code и любым MCP-совместимым клиентом.
Что он делает
Парсер на этапе сборки преобразует спецификацию OpenAPI Procore в компактный каталог, а затем автоматически генерирует отдельные MCP-инструменты для каждой операции API. Во время выполнения 7 мета-инструментов позволяют ИИ обнаруживать и вызывать любой эндпоинт Procore:
Инструмент | Назначение |
| Список категорий API с количеством эндпоинтов |
| Список эндпоинтов в категории |
| Полнотекстовый поиск по всем эндпоинтам |
| Получение полной схемы параметров для эндпоинта |
| Выполнение любого вызова API Procore |
| Показать текущую конфигурацию и статус авторизации |
| Установить конфигурацию во время выполнения (company_id, project_id) |
Related MCP server: mcp-clickup
Предварительные требования
Node.js 18+
Учётная запись Procore Developer Portal
Приложение OAuth с типом предоставления Authorization Code
Установите URI перенаправления на
http://localhost
Настройка
git clone https://github.com/TylerIlunga/procore-mcp-server.git
cd procore-mcp-server
npm installСкопируйте пример env-файла и заполните свои учётные данные:
cp .env.example .envPROCORE_CLIENT_ID=your_client_id
PROCORE_CLIENT_SECRET=your_client_secret
PROCORE_COMPANY_ID=your_company_idПо умолчанию сервер предоставляет 7 инструментов обнаружения, и каждый эндпоинт Procore доступен через procore_api_call. Регистрация отдельного инструмента для каждого эндпоинта вместо этого создаёт около 4,7 МБ (~1,2 млн токенов) определений инструментов — больше, чем контекстное окно любой текущей модели, — поэтому такая поверхность включается по желанию:
PROCORE_TOOL_MODE=allПокрытие идентично в обоих режимах; отличается только размер объявляемого списка инструментов. Если вы переключаетесь на all и переходите с версии до v2.0.0, см. data/tool-renames.json для сопоставления старых -> новых имён инструментов.
Вам понадобится файл спецификации OpenAPI Procore, размещённый по пути specs/combined_OAS.json. Этот файл не включён в репозиторий из-за его размера (~54 МБ). Вы можете получить его из документации API Procore.
Соберите каталог и скомпилируйте TypeScript:
npm run buildВыполните аутентификацию в Procore (откроется браузер для OAuth):
npm run authЗапустите сервер:
npm startКонфигурация Claude Desktop
Добавьте в конфигурацию Claude Desktop (~/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
Добавьте в .mcp.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"
}
}
}
}Структура проекта
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 (committed): catalog.json, endpoint details, tools manifest
specs/ Source OAS file (gitignored — too large for the repo)Как это работает
Время сборки:
scripts/generate-catalog.tsанализирует спецификацию OpenAPI Procore размером ~54 МБ (3 155 операций) и создаёт компактныйdata/catalog.json, а также отдельные файлы с деталями эндпоинтов вdata/endpoint-details/. Затемscripts/generate-tools-manifest.tsсоздаёт манифест инструментов с одним именованным MCP-инструментом для каждой операции API — всего 2 929, после объединения дубликатов старых версий одного и того же пути.Каждый сгенерированный инструмент содержит структурированное описание, охватывающее то, на что он воздействует, когда его следует использовать, какие родительские id нужно сначала разрешить, что он возвращает и как завершается с ошибкой. Эндпоинты, которые Procore объявил устаревшими, регистрируются с датой прекращения поддержки в описании и заголовком
(Deprecated). Интерактивные эндпоинты/oauth/*не регистрируются как инструменты — за этот процесс отвечаетnpm run auth, — но остаются доступными черезprocore_api_call.Аутентификация: Выполните
npm run authодин раз, чтобы завершить процесс OAuth в браузере. Токены сохраняются в~/.procore-mcp/tokens.jsonи автоматически обновляются по истечении срока действия.Время выполнения: MCP-сервер загружает каталог и регистрирует 7 инструментов обнаружения (а также полную поверхность для каждого эндпоинта, когда
PROCORE_TOOL_MODE=all). Когда ИИ-ассистент вызывает инструмент, сервер сопоставляет его с правильным эндпоинтом API Procore, добавляет заголовки аутентификации, обрабатывает ограничения частоты запросов и пагинацию и возвращает ответ.
Вдохновение
Создан, чтобы помочь моей девушке, инженеру-строителю, которая ежедневно пользуется Procore.
Лицензия
MIT
Available Tools
7 toolsprocore_api_callExecute Any Procore API CallADestructive
Executes any Procore REST API call. This is the only tool here that reaches Procore and the only one that can change data — resolve the exact method, path, and parameters with procore_get_endpoint_details first. WRITES ARE REAL: DELETE permanently removes the record, POST creates one, and PATCH/PUT overwrite fields, so confirm the target id before calling and prefer a GET to verify it exists. Handles OAuth from the saved tokens, substitutes {placeholders} from path_params, and rewrites double underscores in query keys into brackets (filters__status becomes filters[status]). company_id and project_id fall back to whatever procore_set_config holds when the path needs them and you omit them. Returns the parsed JSON response together with pagination and rate-limit metadata. Failures come back as an error payload carrying the HTTP status — commonly 401 when the token has expired, 403 without tool permission, 404 when an id does not resolve, 422 when the body fails validation, and 429 when the rate limit is exhausted. Step 4 of the workflow; this reaches every Procore endpoint, including any not exposed as a dedicated tool.
Inputs: path (required), method (required), body, page, +4 more.
procore_discover_categoriesDiscover Procore API CategoriesARead-onlyIdempotent
Lists Procore's API surface as a Category > Module tree with an endpoint count for each. Start here when you do not yet know which part of Procore holds the data you need; if you already know the resource by name ('RFI', 'budget'), procore_search_endpoints gets you there in one step instead of three. The category and module names returned are the exact values procore_discover_endpoints expects. Takes no arguments and returns a JSON object. Reads the catalog bundled with this server, so it makes no Procore request and needs no authentication — it cannot fail with 401/403 and costs no rate limit. Step 1 of the discover -> detail -> call workflow.
Inputs: no named parameters.
procore_discover_endpointsDiscover Endpoints in a CategoryARead-onlyIdempotent
Lists the Procore endpoints inside one category or module, optionally narrowed by a summary substring or HTTP method. Use it after procore_discover_categories to enumerate a focused area; prefer procore_search_endpoints when you have a keyword but no category. Every argument is optional, but omitting all of them returns the entire ~3,100-endpoint catalog, so pass at least a category or a search term. Returns a JSON array of {operationId, summary, method, path}; feed an operationId to procore_get_endpoint_details. Filters that match nothing return an empty array, not an error. Reads the bundled catalog: no Procore request, no authentication, no rate-limit cost. Step 2 of the workflow.
Inputs: module, search, category, method_filter.
procore_get_configShow Server ConfigurationARead-onlyIdempotent
Reports this server's current state: whether Procore OAuth tokens are present and still valid, the default company_id, and the active project_id that procore_api_call substitutes when you omit those parameters. Check this first when a call fails with 401 or 403, or to confirm which project subsequent calls will target before running a write. Never returns token values or the client secret — only whether credentials are present. Takes no arguments and returns a JSON object. Reads local process state, so it makes no Procore request. Pair with procore_set_config to change any of it.
Inputs: no named parameters.
procore_get_endpoint_detailsGet Full Endpoint DetailsARead-onlyIdempotent
Returns the complete parameter schema for one Procore endpoint: every path, query, and body field with its type and required flag, plus the response shape. Call this after discovery and before procore_api_call — api_call needs exact parameter names, and guessing them is the most common cause of a rejected request. Takes the operationId string that procore_discover_endpoints and procore_search_endpoints return; an unrecognized operation_id comes back as a not-found message rather than an error. Reads the bundled catalog: no Procore request, no authentication, no rate-limit cost. Step 3 of the workflow.
Inputs: operation_id (required).
procore_search_endpointsFull-Text Search Across EndpointsARead-onlyIdempotent
Searches every Procore endpoint's summary, tag, and path for a term and returns the matches ranked by relevance. This is the fastest way in when you already know roughly what you want ('punch list', 'submittal', 'budget line item'); reach for procore_discover_categories instead when you want to browse the API surface rather than search it. Returns a JSON array of {operationId, summary, method, path}; feed an operationId to procore_get_endpoint_details to get its parameters. A term with no matches returns an empty array, so retry with a broader or singular form before concluding the endpoint does not exist. Reads the bundled catalog: no Procore request, no authentication, no rate-limit cost.
Inputs: query (required).
procore_set_configSet Runtime Configuration ValueAIdempotent
Sets the default company_id or project_id that later procore_api_call requests use when the path needs one and you omit it. Use it to switch project context mid-session instead of restarting the server, then call procore_get_config to confirm what took effect. Only 'company_id' and 'project_id' are accepted; both are coerced to integers, and a non-numeric value is reported back as a message rather than stored. The change lives in memory for this server process only — it is never written to disk and is lost on restart. Setting the same value twice is a no-op, and nothing in Procore is modified: this only changes which ids this server fills in for you. Returns a confirmation plus the full updated configuration.
Inputs: key (required), value (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clearly distinct role: browse categories, search endpoints, get endpoint details, execute an API call, and read/write config. Even discover_endpoints and search_endpoints both return endpoints, but their descriptions frame them as browse vs. keyword lookup, so an agent should not misselect.
All tools share a procore_ snake_case prefix and most follow a verb_noun pattern (discover_categories, get_config, search_endpoints). The one outlier is procore_api_call, which reads as noun_noun rather than call_api, but it remains clear and does not create real confusion.
Seven tools is well-scoped for a generic API-access server: discovery, search, schema inspection, execution, and config get/set each earn their place. There is no redundancy and no obvious missing companion tool.
The tool set fully covers its stated discover -> detail -> call workflow, with search added for faster lookup and config tools for context switching. Since procore_api_call can reach every Procore endpoint, no dedicated per-resource tools are needed for the server's purpose.
Maintenance
Related MCP Connectors
The official Planning Center MCP server for interacting with your ministry's data.
An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform
The official MCP Server for the Mux API
MCP server for Product Management
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceMCP server for Huntress API integration1MIT
- MIT
- AlicenseAqualityAmaintenanceMCP server for Huly (task tracker) integration61,170 npm64MIT
- AlicenseBqualityDmaintenanceMCP Server for Git operations, agent templates, and project utilities.953 npmMIT