Install Simplicity AI SDK for Codex on macOS#

Install and configure the Simplicity AI SDK for Codex in Visual Studio Code on macOS.

Prerequisites#

Before you begin, ensure that you have:

  • A supported version of macOS (ARM or x64)

  • Visual Studio Code with the Codex extension enabled

  • Access to the Simplicity AI SDK release that you are installing, such as Beta 1

Install the Silicon Labs Visual Studio Code Extension#

In Visual Studio Code, install the latest release of the Silicon Labs Visual Studio Code extension from the Extension Marketplace.

Download the Installer#

Download Simplicity Installer from the Simplicity Studio® website.

Run the Installer#

  1. In Finder, double-click the .dmg file from the archive.

  2. Drag the SimplicityInstaller icon to the Applications folder.

  3. In Finder, open the Applications folder, and then double-click SimplicityInstaller.

Full Install#

  1. Select Full Install.

  2. Select Install.

  3. Wait for the installation to finish. The time required depends on your network speed.

  4. When the installation is complete, close the installer. You do not need to open Simplicity Studio.

Note: The installer downloads the Simplicity AI SDK tools and skills, copies the skills into the Visual Studio Code global skills location, automatically configures config.toml for Codex, and appends the newly downloaded tools.

Advanced Install#

  1. Select Advanced Install.

  2. Select Install.

  3. Wait for the installation to finish. The time required depends on your network speed.

  4. When the installation is complete, close the installer. You do not need to open Simplicity Studio.

Note: The installer downloads the Simplicity AI SDK tools and skills, copies the skills into the Visual Studio Code global skills location, automatically configures config.toml for Codex, and appends the newly downloaded tools.

Verify the Simplicity AI SDK Installation in Codex#

  1. Open Visual Studio Code.

  2. Open the Codex chat window by selecting the Toggle Chat or Toggle Secondary Sidebar icon.

    Toggle Chat and Toggle Secondary Sidebar icons in Visual Studio CodeToggle Chat and Toggle Secondary Sidebar icons in Visual Studio Code

  3. In the Codex chat window, select the gear icon, and then select Codex Settings.

    Codex Settings in the Codex chat windowCodex Settings in the Codex chat window

  4. Select MCP Servers and verify that you see a similar list of installed Model Context Protocol (MCP) servers.

Servers are usually enabled by default.

Codex MCP Servers listCodex MCP Servers list

Note: If the MCP servers are not listed, repeat the installation steps and confirm that you installed the MCP servers with Simplicity Installer.

Reference: Installer-Generated MCP Entries#

The installer writes the MCP server entries to ~/.codex/config.toml. Use the following sample to confirm your configuration or to restore an entry if automatic registration fails.

Copy only the MCP server tables into your current config.toml. Replace <RootPath> with your home directory, such as /Users/<user>. Do not replace the entire file to avoid losing other Codex settings.

Codex config.toml MCP server entriesCodex config.toml MCP server entries

Codex config.toml MCP server entries continuedCodex config.toml MCP server entries continued

[mcp_servers.silabs-ai-sdk-helpers]
command = "<RootPath>/.silabs/slt/installs/archive/python-v3.10.4/python/bin/python3"
args = ["<RootPath>/.silabs/slt/installs/archive/ai_sdk_local_helpers/ai_sdk_local_helpers.py"]
cwd = "<RootPath>/.silabs/slt/installs/archive/ai_sdk_local_helpers"

[mcp_servers.silabs-build-tool]
command = "<RootPath>/.silabs/slt/installs/archive/python-v3.10.4/python/bin/python3"
args = ["<RootPath>/.silabs/slt/installs/archive/build_tool_mcp/build-tool-mcp/build_tool_server.py"]
cwd = "<RootPath>/.silabs/slt/installs/archive/build_tool_mcp/build-tool-mcp"

[mcp_servers.silabs-gdb-mcp]
command = "<RootPath>/.silabs/slt/installs/archive/python-v3.10.4/python/bin/python3"
args = ["<RootPath>/.silabs/slt/installs/archive/gdb_mcp/gdb-mcp/mcu_debug_tool.py"]
cwd = "<RootPath>/.silabs/slt/installs/archive/gdb_mcp/gdb-mcp"

[mcp_servers.silabs-knowledge-base]
url = "https://mcp.silabs.com/mcp"

[mcp_servers.silabs-knowledge-base.http_headers]
Authorization = "Bearer <token>"

[mcp_servers.silabs-tool-locator]
command = "<RootPath>/.silabs/slt/installs/archive/tool-locator-mcp/tool-locator-mcp"
cwd = "<RootPath>/.silabs/slt/installs/archive/tool-locator-mcp"

Note: The bundled Python version can change between releases. In ~/.silabs/slt/installs/archive, find the installed python-v<version> folder and use its name in the command paths.

Post-Installation Smoke Test#

Confirm that the Simplicity SDK is installed and that the Codex agent can detect it.

  1. After all MCP servers are enabled, enter the following in agent chat:

    What SiSDK version do I have installed?

  2. Confirm that the response is similar to the following:

    Simplicity SDK: version 2026.6.1

Note: The chat prompt uses SiSDK as the literal query text. In documentation prose, refer to the product as Simplicity SDK.

Select Your Language Model#

Select your preferred large language model (LLM) in the chat interface.

Troubleshooting#

  • Verify that Simplicity SDK 2026.6.1 is installed with Simplicity Installer.

  • If the chat session does not use MCP tools, confirm that Codex is in Agent mode.

  • If automatic registration fails, add the missing entries from Reference: Installer-Generated MCP Entries to ~/.codex/config.toml.

Related Topics#