Develop

Meta XR Unity MCP Extension

Updated: May 12, 2026

The Meta XR Unity MCP Extension adds Meta XR-specific tools to Unity’s MCP Server, letting you create and modify Meta Quest VR scenes using text prompts and AI agents.

With the extension installed, you can submit text prompts through your AI agent to perform tasks such as:

Creating, updating, or deleting a GameObject

Moving or rotating GameObjects using relative transforms

Adding an interaction to make a GameObject grabbable

Creating teleport hotspots

Prerequisites

Complete the setup steps outlined in Unity Hello World for Meta Quest VR headsets to create a project with the necessary dependencies.

An account on an AI service that supports MCP Servers. For a list of compatible services, see Unity’s AI Gateway documentation⁠.

Software requirements

Unity Editor 2022.3.15f1 or later (6.1 or later recommended)

Meta XR SDK packages v78 or later

Instructions

Step 1: Set up Unity’s MCP server

Follow the steps in Unity’s MCP getting started guide⁠ to install the Unity MCP package and connect an AI agent.

Step 2: Install the Meta XR Unity MCP Extension

The Meta XR Unity MCP Extension is currently only available on GitHub. Functionality might vary by version.

To install the extension from GitHub:

Open the Package Manager by selecting Window > Package Management > Package Manager.

Click the + (plus sign) to show install options and then select Install package from git URL... from the top left.

Select Install package from git URL in the Package Manager

In the text input area, enter https://github.com/meta-quest/Unity-MCP-Extensions.git and then click Install.

In the Package Manager, select In Project on the left and verify that the Meta XR Unity MCP Extension appears in the list.

Confirm Meta XR Unity MCP Extension appears in the list of packages.

Step 3: Accept the MCP connection

After starting your AI agent, click Accept in the connection request dialog that appears in Unity Editor, as shown below:

Click Accept to let your LLM make changes to your Unity scene.

Note: If the dialog does not appear, see Troubleshooting for steps to manually accept the connection.

Step 4: Send text prompt commands

From the MCP Server provider UI, try submitting the following text prompts to update your scene:

Add a cube with distance grab enabled

Set up ray and poke interactions for all UI elements

Add a teleport hotspot at the center of the scene

Troubleshooting

The MCP Connection Request dialog does not appear after starting the LLM MCP server or the LLM throws an error when attempting to update the project.

Navigate to Project Settings > MCP Server > Other Connections. This displays a list of all the attempted connections and their acceptance or rejection status. For any rejected connection, expand the Connection Details section, verify the details match your connection attempt, and then click Accept.

The extension crashes Unity or behaves unexpectedly.

To view or leave feedback about unexpected behavior of the extension, navigate to the Meta Quest Developer Feedback Center and click View investigations in the VR section.