Autodesk Construction Cloud (ACC) MCP Server

by itaico82

354 downloads
Not rated
GitHub

About

Model Context Protocol (MCP) server for Autodesk Construction Cloud Issues API

Details

Author
itaico82
Downloads
354
Categories
Other, API

- 3‑legged OAuth authentication handling
- Natural language to issue field mapping
- Metadata caching reduces API calls
- Comprehensive field validation per ACC requirements
- Clear and actionable error messages

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Autodesk Construction Cloud (ACC) MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install Python 3.10+, set up an Autodesk Forge application with 3‑legged OAuth, and configure environment variables (ACC_CLIENT_ID, ACC_CLIENT_SECRET, ACC_REDIRECT_URI, ACC_PROJECT_ID, ACC_API_URL, ACC_CALLBACK_PORT). Clone the repository, create a virtual environment, install dependencies with uv pip sync requirements.txt, and start the server with python -m src.main.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "autodesk construction cloud (acc) mcp server": {
            "ACC_MCP_V0.2": {
                "command": "python",
                "args": [
                    "-m",
                    "uv",
                    "venv",
                    ".venv"
                ]
            }
        }
    }
}

McpServers

{
    "ACC_MCP_V0.2": {
        "command": "python",
        "args": [
            "-m",
            "uv",
            "venv",
            ".venv"
        ]
    }
}

Autodesk Construction Cloud (ACC) MCP Server

A Model Context Protocol (MCP) server for Autodesk Construction Cloud Issues API. This server enables AI assistants like Claude to interact with ACC Issues - creating, querying, and managing construction issues.

Overview

This MCP server follows schema-driven Python development principles to provide a robust interface to the Autodesk Construction Cloud Issues API with the following capabilities:

- Create new issues from natural language descriptions
- Query and filter existing issues
- Get detailed issue information
- Search issues with natural language
- Add comments to issues

Key Features

- 3-Legged OAuth Authentication: Securely handles the authentication flow with ACC
- Smart Field Mapping: Maps natural language to appropriate issue fields
- Metadata Caching: Efficiently caches project metadata to minimize API calls
- Comprehensive Validation: Validates all fields according to ACC requirements
- Error Handling: Provides clear and actionable error messages

Prerequisites

- Python 3.10+
- Autodesk Construction Cloud account
- Autodesk Forge application with 3-legged OAuth configured

Setup

Environment Configuration

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.