Log inSubmit server
Vrchat MCP logo

Vrchat MCP

by sawa-zen

Access VRChat friends, avatars, worlds, instances, groups, favorites, invites, and notifications through MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Vrchat MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "sawa-zen-vrchat-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "vrchat-mcp"
      ],
      "env": {
        "VRCHAT_USERNAME": "YOUR_VALUE_HERE",
        "VRCHAT_AUTH_TOKEN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 18 tools correctly (24d ago).

Overview

The sawa-zen/vrchat-mcp MCP server exposes VRChat API operations through the Model Context Protocol. It uses a VRChat username and authentication token, then runs as an npm-launched stdio process that an MCP client can call. Reach for it when an agent needs to search VRChat data or perform supported actions such as sending friend requests, changing avatars, joining groups, or creating instances.

Use cases

  • Search VRChat worlds and avatars
  • Review friends, favorites, invites, and notifications
  • Send friend requests and request invites
  • Switch avatars or create instances
  • Search for and join VRChat groups

Key features

  • VRChat API access over MCP
  • Friend and invitation management
  • Avatar and world search
  • Instance creation and lookup
  • Group search and joining
  • Favorites and notification retrieval

Tools18

What Vrchat MCP lets your agent do. Expand a tool for its parameters.

Verified live~2.9k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

22/23 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · vrchat-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars70Stargazers on the source repository.
npm downloads157Package downloads in the last 30 days.
Last commit8mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed18Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Vrchat MCP works

What sawa-zen/vrchat-mcp does

The sawa-zen/vrchat-mcp MCP server connects an MCP client to the VRChat API and presents selected API operations as structured tools. It covers both read and write actions across common VRChat resources, including friends, avatars, worlds, instances, groups, favorites, invites, and notifications.

This makes the server relevant to the 🎮 Gaming category for workflows where an agent needs to inspect VRChat account data or initiate supported account actions. It does not provide a general-purpose VRChat client; the available behavior is defined by the listed MCP tools.

How it works

The server runs over standard input and output. After receiving VRChat credentials through environment variables, it authenticates requests against the VRChat API and makes the resulting operations available to the connected MCP client. The package can be started with npx vrchat-mcp.

Authentication requires VRCHAT_USERNAME and VRCHAT_AUTH_TOKEN. The repository documents obtaining an auth token with npx vrchat-auth-token-checker; that process may request a password and, when enabled, a two-factor authentication code.

Setup and configuration

Set the required variables in the environment before starting the package:

server.ts
export VRCHAT_USERNAME=your_username
export VRCHAT_AUTH_TOKEN=your_auth_token
npx vrchat-mcp

For Claude Desktop, add an mcpServers entry that invokes npx with vrchat-mcp as its argument and passes both variables in the env object. The documented configuration paths are ~/Library/Application Support/Claude/claude_desktop_config.json on macOS and %APPDATA%\\Claude\\claude_desktop_config.json on Windows. Users running through nodenv or nvm may need to provide the full path to npx.

For local development or troubleshooting, install dependencies and build with npm install followed by npm run build. The MCP Inspector can then launch ./dist/main.js for browser-based inspection of the stdio server.

Tools and capabilities

The available tools are grouped by VRChat resource:

  • Friends: list friends and send friend requests.
  • Avatars: search avatars and switch to a selected avatar.
  • Worlds: search worlds and list favorited worlds.
  • Instances: create an instance and retrieve details for a specific instance.
  • Groups: search groups and join a group.
  • Favorites: list favorites, add a favorite, and list favorite groups.
  • Invites: list invite messages, request an invite, and retrieve a specific invite message.
  • Notifications: retrieve notifications.

The sawa-zen/vrchat-mcp MCP server therefore supports both information retrieval and selected mutations, including friend requests, avatar selection, instance creation, group joining, and adding favorites.

Limitations and notes

Authentication is credential-based and depends on a valid VRChat username and token. Treat the token as sensitive because its lifetime may be long.

The package is designed for stdio-based MCP use. If startup or tool calls fail during development, the project recommends building first, checking the environment variables, and using MCP Inspector to examine the running process.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Vrchat MCP

sawa-zen/vrchat-mcp is an MCP server that connects AI clients to the VRChat API through tools for friends, avatars, worlds, instances, groups, favorites, invites, and notifications. It supports retrieving VRChat information and actions such as sending friend requests, selecting avatars, joining groups, and creating instances.

Run it with `npx vrchat-mcp` after setting `VRCHAT_USERNAME` and `VRCHAT_AUTH_TOKEN`. For development, install dependencies with `npm install` and build with `npm run build`.

Add an `mcpServers` entry that runs `npx` with `vrchat-mcp` as the argument and supplies the VRChat username and auth token in `env`. The README provides separate configuration paths for macOS and Windows.

Use `npx vrchat-auth-token-checker` to log in and obtain the token. Enter the VRChat username, password, and a two-factor authentication code when required, then store the long-lived token securely.

Yes, it uses the standard stdio MCP transport supported by Cursor. Configure Cursor with the command and environment variables required to launch `npx vrchat-mcp`.

Related MCP servers

All in Communication All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewVrchat MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/sawa-zen-vrchat-mcp?style=directory)](https://allmcps.com/mcp/sawa-zen-vrchat-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/sawa-zen-vrchat-mcp"><img src="https://allmcps.com/api/badge/sawa-zen-vrchat-mcp?style=directory" alt="Vrchat MCP on AllMCPs" /></a>