VRChat MCP Server
by basic-bitio.github.BASIC-BIT/vrchat-mcpv0.1.15
MCP server for VRChat friends, worlds, groups, events, notifications, and VRCX history.
context tax
queued
security
queued
cold start
queued
freshness
Active10d ago
Install VRChat MCP server
Install in Claude Code
claude mcp add vrchat -- npx -y @basicbit/vrchat-mcpInstall in Cursor
{
"mcpServers": {
"vrchat": {
"command": "npx",
"args": [
"-y",
"@basicbit/vrchat-mcp"
]
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"vrchat": {
"command": "npx",
"args": [
"-y",
"@basicbit/vrchat-mcp"
]
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"vrchat": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@basicbit/vrchat-mcp"
]
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"vrchat": {
"command": "npx",
"args": [
"-y",
"@basicbit/vrchat-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| VRCHAT_MCP_CONFIG_FILE | — | — | Path to a JSON config file for settings not supplied through environment variables. |
| VRCHAT_MCP_USER_AGENT | — | — | Descriptive User-Agent for VRChat API requests. |
| VRCHAT_MCP_LOG_LEVEL | — | — | Log level for stderr diagnostics. |
| VRCHAT_MCP_COOKIE_STORE | — | — | Cookie storage backend for VRChat authentication. The keychain mode falls back to file storage if the OS keychain is unavailable. |
| VRCHAT_MCP_COOKIE_FILE | — | — | Cookie file path used when VRCHAT_MCP_COOKIE_STORE is file. |
| VRCHAT_MCP_ALLOW_WRITES | — | — | Allow non-GET VRChat API write operations. Defaults to true for local full-capability use; set to false for read-only mode. |
| VRCHAT_MCP_UPLOAD_ROOTS | — | — | Absolute directories from which local PNG uploads may be read. Separate multiple roots with the platform path delimiter. |
Freshness
Active — last maintenance signal 10d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-30 · 10d ago · GitHub
Latest release
2026-09-11 · 28d ago · GitHub · v0.1.15
Package published
no data · npm/PyPI
Registry entry updated
2026-09-11 · 28d ago · official registry · v0.1.15
FAQ
›How do I install the VRChat MCP server in Claude Code?
Run: claude mcp add vrchat -- npx -y @basicbit/vrchat-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does VRChat require an API key?
No required environment variables are declared in its published metadata.
›Can I use VRChat as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is VRChat in the official MCP registry?
Yes, as io.github.BASIC-BIT/vrchat-mcp.