APS

v1.0.0Cloud Servicesstable

Simple prototype MCP server integrating Autodesk APIs

apsmcpai-integration
Share:
20
Stars
0
Downloads
0
Weekly
0/5

What is APS?

APS is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to simple prototype mcp server integrating autodesk apis

Simple prototype MCP server integrating Autodesk APIs

This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Simple prototype MCP server integrating Autodesk APIs

Use Cases

Access Autodesk APIs and services
kpphillips

Maintainer

LicenseGPL-3.0
Languagepython
Versionv1.0.0
UpdatedMay 18, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx aps

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use APS

The APS MCP Server is a Python-based prototype that connects AI assistants to Autodesk Platform Services (formerly Forge), enabling natural-language queries against Autodesk Construction Cloud (ACC) and BIM360 data. It exposes four tools for navigating the hub, project, folder, and item/version hierarchy of Autodesk's Document Management APIs. Security researchers, BIM coordinators, and construction tech developers can use it to explore project structures, retrieve file versions, and build AI-powered workflows on top of Autodesk's cloud storage.

Prerequisites

  • Python 3.10 or later installed
  • uv or pip for dependency management
  • Autodesk Platform Services credentials (Client ID, Client Secret, or 3-legged OAuth token) — obtain from the Autodesk Developer Portal
  • Access to an Autodesk ACC or BIM360 hub with projects
  • An MCP-compatible client such as Claude Desktop
1

Clone the repository

Download the APS MCP Server source code. The project is not published to PyPI, so you run it directly from source.

git clone https://github.com/kpphillips/aps-mcp-server.git
cd aps-mcp-server
2

Create your .env file with Autodesk credentials

Copy the sample env file and fill in your Autodesk APS credentials. The exact variable names are defined in .env.sample in the repository.

cp .env.sample .env
# Edit .env and add your Autodesk APS Client ID, Client Secret, and account credentials
3

Install dependencies with uv (recommended)

Create a virtual environment and install the required Python packages using uv.

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -r requirements.txt
4

Configure Claude Desktop

Add the server to Claude Desktop's config file at ~/Library/Application Support/Claude/claude_desktop_config.json. Use absolute paths to both the Python executable in your venv and the server script.

{
  "mcpServers": {
    "aps": {
      "command": "/absolute/path/to/aps-mcp-server/.venv/bin/python3",
      "args": ["/absolute/path/to/aps-mcp-server/aps_dm_server.py"],
      "env": {
        "PYTHONPATH": "/absolute/path/to/aps-mcp-server"
      }
    }
  }
}
5

Restart Claude Desktop and test

Restart Claude Desktop to load the server. Ask Claude to list your Autodesk hubs — if the credentials are valid and the server is running, it will return your accessible hubs.

APS Examples

Client configuration

Claude Desktop configuration for the APS MCP server running from a Python virtual environment.

{
  "mcpServers": {
    "aps": {
      "command": "/Users/you/aps-mcp-server/.venv/bin/python3",
      "args": ["/Users/you/aps-mcp-server/aps_dm_server.py"],
      "env": {
        "PYTHONPATH": "/Users/you/aps-mcp-server"
      }
    }
  }
}

Prompts to try

Example prompts for navigating Autodesk ACC / BIM360 data through Claude.

- "List all hubs I have access to in Autodesk Construction Cloud"
- "Show me all projects in the hub named 'My Company'"
- "List the files in the 'Project Files' folder of the Riverside Tower project"
- "Get the version history for the file 'Structural Model v3.rvt'"
- "What projects am I a member of across all my Autodesk hubs?"

Troubleshooting APS

Authentication fails with 403 or 'token expired' errors

Autodesk APS uses short-lived OAuth tokens. Ensure your .env file contains valid credentials and that your APS app has the correct scopes (data:read at minimum) enabled in the Autodesk Developer Portal.

get_projects returns an empty list even though projects exist

The account you authenticated with may not have been provisioned for the hub. Check that your Autodesk account has access to the relevant ACC hub in the Autodesk web UI first.

ModuleNotFoundError when Claude Desktop launches the server

Ensure the 'command' in your Claude Desktop config points to the Python executable inside your virtual environment (.venv/bin/python3), not the system Python. Also verify PYTHONPATH is set to the project directory.

Frequently Asked Questions about APS

What is APS?

APS is a Model Context Protocol (MCP) server that simple prototype mcp server integrating autodesk apis It connects AI assistants to external tools and data sources through a standardized interface.

How do I install APS?

Follow the installation instructions on the APS GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with APS?

APS works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is APS free to use?

Yes, APS is open source and available under the GPL-3.0 license. You can use it freely in both personal and commercial projects.

Browse More Cloud Services MCP Servers

Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "aps": { "command": "npx", "args": ["-y", "aps"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use APS?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides