APS
Simple prototype MCP server integrating Autodesk APIs
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
Maintainer
Works with
Installation
Manual Installation
npx apsConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
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
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-serverCreate 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 credentialsInstall 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.txtConfigure 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"
}
}
}
}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.
APS Alternatives — Similar Cloud Services Servers
Looking for alternatives to APS? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
★ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
★ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
★ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
★ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
★ 26.7k本项目为xiaozhi-esp32提供后端服务,帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
★ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
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.
Set Up APS in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
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.