Skip to content
Back to search

sketchup-mcp

Sketchup Model Context Protocol

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mhyrr--sketchup-mcp/badge.svg)](/listings/mhyrr--sketchup-mcp)

HTML

<a href="/listings/mhyrr--sketchup-mcp"><img src="/api/listings/mhyrr--sketchup-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Python Packaging

We're using uv so you'll need to ```brew install uv```

Sketchup Extension

1. Download or build the latest `.rbz` file 2. In Sketchup, go to Window > Extension Manager 3. Click "Install Extension" and select the downloaded `.rbz` file 4. Restart Sketchup

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 106 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # SketchupMCP - Sketchup Model Context Protocol Integration
  2. SketchupMCP connects Sketchup to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Sketchup. This integration enables prompt-assisted 3D modeling, scene creation, and manipulation in Sketchup.
  3. Big Shoutout to [Blender MCP](https://github.com/ahujasid/blender-mcp) for the inspiration and structure.
  4. ## Features
  5. * **Two-way communication**: Connect Claude AI to Sketchup through a TCP socket connection
  6. * **Component manipulation**: Create, modify, delete, and transform components in Sketchup
  7. * **Material control**: Apply and modify materials and colors
  8. * **Scene inspection**: Get detailed information about the current Sketchup scene
  9. * **Selection handling**: Get and manipulate selected components
  10. * **Ruby code evaluation**: Execute arbitrary Ruby code directly in SketchUp for advanced operations
  11. ## Components
  12. The system consists of two main components:
  13. 1. **Sketchup Extension**: A Sketchup extension that creates a TCP server within Sketchup to receive and execute commands
  14. 2. **MCP Server (`sketchup_mcp/server.py`)**: A Python server that implements the Model Context Protocol and connects to the Sketchup extension
  15. ## Installation
  16. ### Python Packaging
  17. We're using uv so you'll need to ```brew install uv```
  18. ### Sketchup Extension
  19. 1. Download or build the latest `.rbz` file
  20. 2. In Sketchup, go to Window > Extension Manager
  21. 3. Click "Install Extension" and select the downloaded `.rbz` file
  22. 4. Restart Sketchup
  23. ## Usage
  24. ### Starting the Connection
  25. 1. In Sketchup, go to Extensions > SketchupMCP > Start Server
  26. 2. The server will start on the default port (9876)
  27. 3. Make sure the MCP server is running in your terminal
  28. ### Using with Claude
  29. Configure Claude to use the MCP server by adding the following to your Claude configuration:
  30. ```json
  31. "mcpServers": {
  32. "sketchup": {
  33. "command": "uvx",
  34. "args": [
  35. "sketchup-mcp"
  36. ]
  37. }
  38. }
  39. ```
  40. This will pull the [latest from PyPI](https://pypi.org/project/sketchup-mcp/)
  41. Once connected, Claude can interact with Sketchup using the following capabilities:
  42. #### Tools
  43. * `get_scene_info` - Gets information about the current Sketchup scene
  44. * `get_selected_components` - Gets information about currently selected components
  45. * `create_component` - Create a new component with specified parameters
  46. * `delete_component` - Remove a component from the scene
  47. * `transform_component` - Move, rotate, or scale a component
  48. * `set_material` - Apply materials to components
  49. * `export_scene` - Export the current scene to various formats
  50. * `eval_ruby` - Execute arbitrary Ruby code in SketchUp for advanced operations
  51. ### Example Commands
  52. Here are some examples of what you can ask Claude to do:
  53. * "Create a simple house model with a roof and windows"
  54. * "Select all components and get their information"
  55. * "Make the selected component red"
  56. * "Move the selected component 10 units up"
  57. * "Export the current scene as a 3D model"
  58. * "Create a complex arts and crafts cabinet using Ruby code"
  59. ## Troubleshooting
  60. * **Connection issues**: Make sure both the Sketchup extension server and the MCP server are running
  61. * **Command failures**: Check the Ruby Console in Sketchup for error messages
  62. * **Timeout errors**: Try simplifying your requests or breaking them into smaller steps
  63. ## Technical Details
  64. ### Communication Protocol
  65. The system uses a simple JSON-based protocol over TCP sockets:
  66. * **Commands** are sent as JSON objects with a `type` and optional `params`
  67. * **Responses** are JSON objects with a `status` and `result` or `message`
  68. ## Contributing
  69. Contributions are welcome! Please feel free to submit a Pull Request.
  70. ## License
  71. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.