VRChat MCP

Unofficial local Model Context Protocol tools for VRChat friends, worlds, groups, events, notifications, status, invites, and local VRCX history.

People who work with opencode, vrchat and vrcx and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-11 · ★ 2 · #51 OF 278 MAINTAINED API INTEGRATION · VERIFIED 2026-09-18

MIT · TypeScript servers · how we verify → /methodology

01 · Install VRChat MCP

before you install - you'll need

Set VRCHAT_MCP_ALLOW_WRITES, VRCHAT_MCP_COOKIE_FILE, VRCHAT_MCP_USERNAME, VRCHAT_MCP_PASSWORD, VRCHAT_MCP_TOTP_SECRET before connecting. VRCHAT_MCP_COOKIE_STORE is optional or environment-specific per the README.

Claude Code

claude mcp add basic-bit-vrchat-mcp -- npx -y @basicbit/vrchat-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "basic-bit-vrchat-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@basicbit/vrchat-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @basicbit/vrchat-mcp - the @basicbit scope differs from the repo owner (basic-bit); confirm it's the project's official package

registry namespace io.github.BASIC-BIT is GitHub-verified and matches the repo owner

03 · What VRChat MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.1.15 · 2026-09-11

[AGENT] This release lets bot accounts that use TOTP two-factor authentication stay logged in without a human, and refreshes the generated VRChat schemas to community specification v1.20.9. · Headless re-login is…

v0.1.14 · 2026-09-08

[AGENT] This release adds account-gallery management for deployments that need to reuse artwork and clean up unwanted uploads. · vrchat_gallery_images returns the complete gallery with compact metadata and a total…

v0.1.13 · 2026-09-02

[AGENT] · VRChat MCP v0.1.13 · Replace vrchat_group_image_upload with vrchat_gallery_image_upload. The upload endpoint creates a file in the signed-in user's personal gallery and has no group authorization…

04 · Who maintains VRChat MCP

VRChat MCP is maintained by basic-bit. It's the only MCP server we track from this author; the repo dates to Dec 2025.

05 · Facts

repository: github.com/basic-bit/vrchat-mcp
website: https://github.com/BASIC-BIT/vrchat-mcp#readme
category: API integration - ranked #51 of 278 actively-maintained API integration servers as of 2026-09-18.
release cadence: 8 releases in the last 90 days (latest 2026-09-11)
registry: io.github.BASIC-BIT/vrchat-mcp (active, first published 2026-05-17 · 14 versions)
packages: npm:@basicbit/vrchat-mcp

06 · VRChat MCP FAQ

What is VRChat MCP?

Unofficial local Model Context Protocol tools for VRChat friends, worlds, groups, events, notifications, status, invites, and local VRCX history.

Is VRChat MCP still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-11 and it shipped 8 releases in the last 90 days. We re-verify nightly.

How do I install VRChat MCP?

Run `npx -y @basicbit/vrchat-mcp`. The README documents 6 environment variables (VRCHAT_MCP_ALLOW_WRITES, VRCHAT_MCP_COOKIE_STORE, VRCHAT_MCP_COOKIE_FILE…) to set first. Set VRCHAT_MCP_ALLOW_WRITES, VRCHAT_MCP_COOKIE_FILE, VRCHAT_MCP_USERNAME, VRCHAT_MCP_PASSWORD, VRCHAT_MCP_TOTP_SECRET before connecting. VRCHAT_MCP_COOKIE_STORE is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does VRChat MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to VRChat MCP

Alternatives to VRChat MCP

Maintained API integration servers if VRChat MCP isn't the fit.

More API integration MCP servers · OpenSTAAD MCP Server · Genefoundry · Easy Bits · Boostu Teamleader MCP · Brilliant Directories MCP

More TypeScript MCP servers · Parecode · Beat Design · Chronoverify · Mcpwall · The Neural Ledger Intelligence · see all