color_elements

Assign distinct colors to elements in Revit views based on category and parameter values, enabling visual grouping and analysis. Customize colors or use gradients for enhanced clarity.

Instructions

Color elements in the current view based on a category and parameter value. Each unique parameter value gets assigned a distinct color.

Input Schema

Name	Required	Description
`categoryName`	Yes	The name of the Revit category to color (e.g., 'Walls', 'Doors', 'Rooms')
`customColors`	No	Optional array of custom RGB colors to use for specific parameter values
`parameterName`	Yes	The name of the parameter to use for grouping and coloring elements
`useGradient`	No	Whether to use a gradient color scheme instead of random colors

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "categoryName": {
      "description": "The name of the Revit category to color (e.g., 'Walls', 'Doors', 'Rooms')",
      "type": "string"
    },
    "customColors": {
      "description": "Optional array of custom RGB colors to use for specific parameter values",
      "items": {
        "additionalProperties": false,
        "properties": {
          "b": {
            "maximum": 255,
            "minimum": 0,
            "type": "integer"
          },
          "g": {
            "maximum": 255,
            "minimum": 0,
            "type": "integer"
          },
          "r": {
            "maximum": 255,
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "r",
          "g",
          "b"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "parameterName": {
      "description": "The name of the parameter to use for grouping and coloring elements",
      "type": "string"
    },
    "useGradient": {
      "default": false,
      "description": "Whether to use a gradient color scheme instead of random colors",
      "type": "boolean"
    }
  },
  "required": [
    "categoryName",
    "parameterName"
  ],
  "type": "object"
}

Revit MCP Server

color_elements

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Revit MCP Server

Related Tools