Aps Mcp Server

> IMPORTANT: This project has been moved to https://github.com/autodesk-platform-services/aps-mcp-server-nodejs.

---

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.

YouTube Video

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 ID
• APS_CLIENT_SECRET - your APS application client secret
• Create a new service account: npx create-service-account , 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 ID
• APS_SA_EMAIL - your service account email
• APS_SA_KEY_ID - your service account key ID
• APS_SA_PRIVATE_KEY - your service account private key
• 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:

{
    "mcpServers": {
        "autodesk-platform-services": {
            "command": "node",
            "args": [
                "/absolute/path/to/aps-mcp-server/build/server.js"
            ]
        }
    }
}

• 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:

{
    "servers": {
        "Autodesk Platform Services": {
            "type": "stdio",
            "command": "node",
            "args": [
                "/absolute/path/to/aps-mcp-server/build/server.js"
            ]
        }
    }
}

> 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:

{
  "mcpServers": {
    "Autodesk Platform Services": {
      "command": "node",
      "args": [
        "/Users/brozp/Code/Temp/aps-mcp-server-node/build/server.js"
      ]
    }
  }
}

> For more details on how to add MCP servers to Cursor, see the documentation

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: petrbroz
• Source: petrbroz/aps-mcp-server
• License: MIT

Install and usage instructions live in the source repository linked above.