VRChat MCP MCP Server

Name: VRChat MCP MCP Server
Author: io.github.BASIC-BIT

io.github.BASIC-BIT/vrchat-mcp

Repository Registry

What is the VRChat MCP MCP server?

MCP server for VRChat friends, worlds, groups, events, notifications, and VRCX history.

How to install VRChat MCP

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "vrchat-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@basicbit/vrchat-mcp"
      ],
      "env": {
        "VRCHAT_MCP_CONFIG_FILE": "<YOUR_VRCHAT_MCP_CONFIG_FILE>",
        "VRCHAT_MCP_USER_AGENT": "<YOUR_VRCHAT_MCP_USER_AGENT>",
        "VRCHAT_MCP_LOG_LEVEL": "<YOUR_VRCHAT_MCP_LOG_LEVEL>",
        "VRCHAT_MCP_COOKIE_STORE": "<YOUR_VRCHAT_MCP_COOKIE_STORE>",
        "VRCHAT_MCP_COOKIE_FILE": "<YOUR_VRCHAT_MCP_COOKIE_FILE>",
        "VRCHAT_MCP_ALLOW_WRITES": "<YOUR_VRCHAT_MCP_ALLOW_WRITES>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "vrchat-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@basicbit/vrchat-mcp"
      ],
      "env": {
        "VRCHAT_MCP_CONFIG_FILE": "<YOUR_VRCHAT_MCP_CONFIG_FILE>",
        "VRCHAT_MCP_USER_AGENT": "<YOUR_VRCHAT_MCP_USER_AGENT>",
        "VRCHAT_MCP_LOG_LEVEL": "<YOUR_VRCHAT_MCP_LOG_LEVEL>",
        "VRCHAT_MCP_COOKIE_STORE": "<YOUR_VRCHAT_MCP_COOKIE_STORE>",
        "VRCHAT_MCP_COOKIE_FILE": "<YOUR_VRCHAT_MCP_COOKIE_FILE>",
        "VRCHAT_MCP_ALLOW_WRITES": "<YOUR_VRCHAT_MCP_ALLOW_WRITES>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "vrchat-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@basicbit/vrchat-mcp"
      ],
      "env": {
        "VRCHAT_MCP_CONFIG_FILE": "<YOUR_VRCHAT_MCP_CONFIG_FILE>",
        "VRCHAT_MCP_USER_AGENT": "<YOUR_VRCHAT_MCP_USER_AGENT>",
        "VRCHAT_MCP_LOG_LEVEL": "<YOUR_VRCHAT_MCP_LOG_LEVEL>",
        "VRCHAT_MCP_COOKIE_STORE": "<YOUR_VRCHAT_MCP_COOKIE_STORE>",
        "VRCHAT_MCP_COOKIE_FILE": "<YOUR_VRCHAT_MCP_COOKIE_FILE>",
        "VRCHAT_MCP_ALLOW_WRITES": "<YOUR_VRCHAT_MCP_ALLOW_WRITES>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "vrchat-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@basicbit/vrchat-mcp"
      ],
      "env": {
        "VRCHAT_MCP_CONFIG_FILE": "<YOUR_VRCHAT_MCP_CONFIG_FILE>",
        "VRCHAT_MCP_USER_AGENT": "<YOUR_VRCHAT_MCP_USER_AGENT>",
        "VRCHAT_MCP_LOG_LEVEL": "<YOUR_VRCHAT_MCP_LOG_LEVEL>",
        "VRCHAT_MCP_COOKIE_STORE": "<YOUR_VRCHAT_MCP_COOKIE_STORE>",
        "VRCHAT_MCP_COOKIE_FILE": "<YOUR_VRCHAT_MCP_COOKIE_FILE>",
        "VRCHAT_MCP_ALLOW_WRITES": "<YOUR_VRCHAT_MCP_ALLOW_WRITES>"
      }
    }
  }
}

Claude Code

claude mcp add vrchat-mcp --env VRCHAT_MCP_CONFIG_FILE=<YOUR_VRCHAT_MCP_CONFIG_FILE> --env VRCHAT_MCP_USER_AGENT=<YOUR_VRCHAT_MCP_USER_AGENT> --env VRCHAT_MCP_LOG_LEVEL=<YOUR_VRCHAT_MCP_LOG_LEVEL> --env VRCHAT_MCP_COOKIE_STORE=<YOUR_VRCHAT_MCP_COOKIE_STORE> --env VRCHAT_MCP_COOKIE_FILE=<YOUR_VRCHAT_MCP_COOKIE_FILE> --env VRCHAT_MCP_ALLOW_WRITES=<YOUR_VRCHAT_MCP_ALLOW_WRITES> -- npx -y @basicbit/vrchat-mcp