Vrchat Mcp Osc

VRChat MCP OSC is an MCP server that connects AI assistants like Claude Desktop directly to VRChat via the Open Sound Control protocol. Virtual reality creators, streamers, and developers use this server to enable language models to interact inside virtual environments in real time. By running an OSC relay and a standardized Model Context Protocol interface, the server allows connected AI agents to query active avatar properties, inspect supported configuration parameters, and modify expression values programmatically. In addition to visual animations and facial morphs, assistants can initiate in-world movement, direct where the avatar looks, trigger jumping, and open the system menu. The server also provides tools for toggling voice states and transmitting text directly through VRChat's native chatbox. Through this setup, users can run interactive AI-driven avatars, automate NPC behaviors in virtual spaces, or perform accessibility actions inside VRChat using plain language commands without manually handling raw OSC network packets.

Category: Other & General Purpose

Tags: avatar-control, osc, virtual-reality, vrchat

Visit Vrchat Mcp Osc

How to install and configure Vrchat Mcp Osc

1. Ensure Node.js 18 or higher is installed and OSC is enabled in your VRChat settings. 2. Clone the repository and link the package: bash git clone https://github.com/Krekun/vrchat-mcp-osc cd vrchat-mcp-osc npm link 3. Add the server to your claude_desktop_config.json file: json { "mcpServers": { "vrchat-mcp-osc": { "command": "npx", "args": [ "vrchat-mcp-osc" ] } } } 4. Restart Claude Desktop and ensure VRChat is open to start controlling your avatar.

What you can do with Vrchat Mcp Osc

• Directing avatar motion and viewpoint changes by asking an AI assistant to move forward, turn toward specific directions, or perform jumping actions in virtual spaces. - Triggering custom avatar animations, facial morphs, and emote parameters dynamically based on conversational context during live streams or virtual gatherings. - Broadcasting text messages directly to the in-game VRChat chatbox using assistant prompts without requiring the user to type on the VR keyboard. - Inspecting current avatar configurations and parameter lists to verify available OSC addresses and supported features before applying interactive changes. - Toggling voice controls and standard VRChat menu interfaces through natural language prompts during interactive VR sessions.

Key facts

• https://github.com/Krekun/vrchat-mcp-osc
• Other & General Purpose
• avatar-control, osc, virtual-reality, vrchat

Part of MCP Servers

How do I install VRChat MCP OSC?

To install VRChat MCP OSC, clone the repository from GitHub and execute npm link inside the project directory. Next, configure Claude Desktop by adding the server definition to your claude_desktop_config.json file using the command npx with vrchat-mcp-osc as the argument. Ensure Node.js 18 or higher is installed and verify that OSC is enabled inside your VRChat client settings before starting.

What can VRChat MCP OSC do?

The server connects AI assistants to VRChat via OSC. It exposes tools that allow models to retrieve avatar names, list and modify avatar parameters, trigger emotes, control movement and look directions, execute jumps, toggle the main menu or voice features, and send messages directly to the VRChat chatbox.

Which MCP clients work with VRChat MCP OSC?

VRChat MCP OSC works with Claude Desktop and any AI client that supports the Model Context Protocol. It communicates through standard MCP input and output streams while routing commands to VRChat over local OSC UDP ports, using port 9000 for outgoing data and port 9001 for incoming data.

What license does VRChat MCP OSC use?

VRChat MCP OSC uses a dual-licensing model. Non-commercial use is licensed under the terms of the MIT License, allowing individuals to run, modify, and redistribute the project freely. Any commercial use of the software requires obtaining a separate commercial license from the project maintainer.

What are the requirements to run VRChat MCP OSC?

You need Node.js 18 or higher, a running instance of VRChat with OSC turned on in its settings, and an MCP-compatible client like Claude Desktop. The default network setup assumes local communication on IP address 127.0.0.1, utilizing port 9000 for sending messages and port 9001 for receiving them.