VRChat MCP
Connects Claude to VRChat's API for managing your social graph, tracking worlds and events, and querying local VRCX history. Exposes curated tools for common tasks like checking friend status, searching worlds, sending invites, and booping, plus generated read/write routers that cover the full API surface. Runs locally via stdio with auth cookies stored in your OS keychain. Write operations are enabled by default but gated through your MCP client's approval flow. Includes safety guardrails like group ID allowlists and rate limit backoff. Useful when you want to automate VRChat social workflows or pull instance data into an LLM conversation without leaving your editor.
- GitHub stars
- 3
- tools
- 20
- transport
- STDIO
- env vars
- 7
- last updated
- Sep 11, 2026
Tools
20 toolsPublic tool metadata for what this MCP can expose to an agent.
vrchat_me
No parameter schema in public metadata yet.
vrchat_friends_overview
No parameter schema in public metadata yet.
vrchat_friends_search
No parameter schema in public metadata yet.
vrchat_friend_details
No parameter schema in public metadata yet.
vrchat_worlds_search
No parameter schema in public metadata yet.
vrchat_group_profile
No parameter schema in public metadata yet.
vrchat_events_upcoming
No parameter schema in public metadata yet.
vrchat_notifications_recent
No parameter schema in public metadata yet.
vrchat_instance_link_event
No parameter schema in public metadata yet.
vrchat_gallery_image_upload
No parameter schema in public metadata yet.
vrchat_invite
No parameter schema in public metadata yet.
vrchat_group_invite
No parameter schema in public metadata yet.
vrchat_friend_request
No parameter schema in public metadata yet.
vrchat_boop
No parameter schema in public metadata yet.
vrcx_instances_recent
No parameter schema in public metadata yet.
vrchat_readRouter tool for available GET operations; pass operationId plus path/query/header/cookie values under params.
Router tool for available GET operations; pass operationId plus path/query/header/cookie values under params.
No parameter schema in public metadata yet.
vrchat_writeRouter tool for available POST/PUT/PATCH operations; pass operationId, params, and JSON payloads under body.
Router tool for available POST/PUT/PATCH operations; pass operationId, params, and JSON payloads under body.
No parameter schema in public metadata yet.
vrchat_deleteRouter tool for available DELETE operations; pass operationId, params, and optional JSON payloads under body.
Router tool for available DELETE operations; pass operationId, params, and optional JSON payloads under body.
No parameter schema in public metadata yet.
vrchat_operationsLists available generated operation IDs.
Lists available generated operation IDs.
No parameter schema in public metadata yet.
vrchat_operation_detailsReturns exact per-operation params/body schemas.
Returns exact per-operation params/body schemas.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
VRCHAT_MCP_CONFIG_FILEPath to a JSON config file for settings not supplied through environment variables.
VRCHAT_MCP_USER_AGENTDescriptive User-Agent for VRChat API requests.
VRCHAT_MCP_LOG_LEVELdefault: infoLog level for stderr diagnostics.
VRCHAT_MCP_COOKIE_STOREdefault: keychainCookie storage backend for VRChat authentication. The keychain mode falls back to file storage if the OS keychain is unavailable.
VRCHAT_MCP_COOKIE_FILECookie file path used when VRCHAT_MCP_COOKIE_STORE is file.
VRCHAT_MCP_ALLOW_WRITESdefault: trueAllow non-GET VRChat API write operations. Defaults to true for local full-capability use; set to false for read-only mode.
VRCHAT_MCP_UPLOAD_ROOTSAbsolute directories from which local PNG uploads may be read. Separate multiple roots with the platform path delimiter.
Readme
VRChat MCP logo
VRChat MCP
Unofficial local Model Context Protocol tools for VRChat friends, worlds, groups, events, notifications, status, invites, and local VRCX history.
VRChat MCP runs locally through stdio by default and also offers an opt-in loopback-only Streamable HTTP mode. Your VRChat auth cookies stay on your machine and default to your OS keychain, with file storage as the fallback when a keychain backend is unavailable. Curated write tools, generated read/write tools, and read-only VRCX local-history tools are available by default; use your MCP client or agent harness to approve account-changing tool calls.
This project is unofficial and is not affiliated with VRChat Inc.
Policy and Safety Boundaries
Details
- Repository
- github.com/basic-bit/vrchat-mcp
- Website
- github.com/BASIC-BIT/vrchat-mcp#readme
- Package
@basicbit/vrchat-mcp- Transport
- STDIO
- Registry
- MCP registry, active