The APS MCP Server provides access to Autodesk Construction Cloud (ACC) data via the Model Context Protocol, enabling users to query and manage construction project information with fine-grained access control. With this server, you can:
List available ACC accounts
Browse projects within a specific ACC account
Navigate folders and subfolders within projects
List and manage issues within projects
Retrieve issue comments, types, and root causes
Access document versions
Enables access to Autodesk Platform Services (APS) API with fine-grained access control, allowing users to view ACC projects, manage issues, and interact with BIM360 data through secure service accounts.
Supports installation and configuration on macOS systems, with specific paths for Claude Desktop configuration.
Built with Node.js to provide a Model Context Protocol server for accessing and interacting with Autodesk Platform Services API.
Implements the MCP server using TypeScript, requiring build steps before running the server.
aps-mcp-server
Experimental Model Context Protocol server build with Node.js, providing access to Autodesk Platform Services API, with fine-grained access control using the new Secure Service Accounts feature.
Development
Prerequisites
- Node.js
- APS app credentials (must be a Server-to-Server application type)
- Provisioned access to ACC or BIM360
Setup
Server
- Clone this repository
- Install dependencies:
yarn install
- Build the TypeScript code:
yarn run build
- Create a .env file in the root folder of this project, and add your APS credentials:
APS_CLIENT_ID
- your APS application client IDAPS_CLIENT_SECRET
- your APS application client secret
- Create a new service account:
npx create-service-account <username> <first name> <last name>
, for example,npx create-service-account ssa-test-user John Doe
- This script will output a bunch of environment variables with information about the new account:
APS_SA_ID
- your service account IDAPS_SA_EMAIL
- your service account emailAPS_SA_KEY_ID
- your service account key IDAPS_SA_PRIVATE_KEY
- your service account private key
- This script will output a bunch of environment variables with information about the new account:
- Add these environment variables to your .env file
Autodesk Construction Cloud
- Register your APS application client ID as a custom integration
- Invite the service account email as a new member to your ACC project(s)
Use with Inspector
- Run the Model Context Protocol Inspector:
yarn run inspect
- Open http://localhost:5173
- Hit
Connect
to start this MCP server and connect to it
Use with Claude Desktop
- Make sure you have Claude Desktop installed
- Create a Claude Desktop config file if you don't have one yet:
- On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- On Windows: %APPDATA%\Claude\claude_desktop_config.json
- Add this MCP server to the config, using the absolute path of the build/server.js file on your system, for example:
- Open Claude Desktop, and try some of the following test prompt:
- What ACC projects do I have access to?
- Give me a visual dashboard of all issues in project XYZ
For more details on how to add MCP servers to Claude Desktop, see the official documentation.
Use with Visual Studio Code & Copilot
- Make sure you have enabled MCP servers in Visual Studio Code
- Create .vscode/mcp.json file in your workspace, and add the following JSON to it:
For more details on how to add MCP servers to Visual Studio Code, see the documentation
Use with Cursor
- Create .cursor/mcp.json file in your workspace, and add the following JSON to it:
For more details on how to add MCP servers to Cursor, see the documentation
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
Experimental Node.js server implementing the Model Context Protocol for accessing Autodesk Platform Services API with fine-grained access control using Secure Service Accounts.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityA comprehensive Model Context Protocol server that provides advanced Node.js development tooling for automating project creation, component generation, package management, and documentation with AI-powered assistance.Last updated -74MIT License
- -securityFlicense-qualityA Model Context Protocol server that enables AI models to access tools through GitHub authentication and provides comprehensive analytics tracking of tool usage, performance, and user behavior.Last updated -3
- -securityAlicense-qualityA Model Context Protocol server implementation for Autodesk Construction Cloud Build that enables AI assistants to manage construction issues, RFIs, submittals, photos, forms, and costs through natural language.Last updated -MIT License