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
- 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 ssa-test-user John Doe
- This script will output an email of the newly created service account, and a bunch of environment variables
- Add or overwrite the new environment variables in your .env file
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
- 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.
You must be authenticated.
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
- -securityFlicense-qualityA Node.js application that provides a Model Context Protocol server for interacting with Harbor container registry, supporting operations for projects, repositories, tags, and Helm charts.Last updated -TypeScript
- -securityAlicense-qualityA Model Context Protocol server that provides seamless integration with Google Workspace, allowing operations with Google Drive, Docs, and Sheets through secure OAuth2 authentication.Last updated -PythonMIT License
- -securityAlicense-qualityNode.js server implementing Model Context Protocol for secure read-only filesystem operations, allowing Claude to read files, list directories, search files, and get file metadata within specified directories.Last updated -91JavaScriptMIT License
- -securityFlicense-qualityNode.js server implementing Model Context Protocol (MCP) for filesystem operations with comprehensive permission controls, allowing secure file and directory manipulation with granular access restrictions.Last updated -38,5321TypeScript