LABSCO SUMMARY

Your own VRChat account, driven locally, with writes on by default and controls to turn them off.

The curated tools do the composition an agent needs — friends grouped by world, an invite that resolves your current instance — while the generated routers keep the rest of the API reachable as it changes. It is scoped to one person on one machine by design: your cookies stay local, and account-changing calls are meant to go through your client's approval step.

What it is

An unofficial local MCP server for VRChat. It runs on your own machine, keeps your VRChat session cookies in the OS keychain, and exposes friends, worlds, groups, events, notifications, status and invites as curated tools, plus read-only access to your local VRCX history.

What you get

vrchat_friends_overview, vrchat_friends_list, vrchat_friends_search and vrchat_friend_details — who is online grouped by status and location, and one friend's profile and whereabouts
vrchat_me, vrchat_user_profile and vrchat_user_groups — your own profile with presence presets, another user's profile, and the groups either of you belong to
vrchat_worlds_search, vrchat_worlds_favorites, vrchat_world_profile and vrchat_world_instances_overview — find worlds, read your favourites, and see instances by access type and region
vrchat_groups_search, vrchat_group_profile, vrchat_group_members, vrchat_group_posts_recent and vrchat_group_instances_overview — group discovery, membership and recent activity
vrchat_events_discover, vrchat_events_upcoming, vrchat_events_search and the group event tools — public calendar events by category or term, and a group's next and upcoming ones
vrchat_event_create, vrchat_event_update, vrchat_event_follow and vrchat_event_delete — write access to group calendar events
vrchat_instance_create, vrchat_invite_self, vrchat_invite_user and vrchat_invite_user_to_me — open an instance and pull people into it; invite_user_to_me resolves your current location for you
vrchat_status_get, vrchat_status_set and vrchat_profile_update — read and set your status and description, and edit bio, pronouns and content filters with status preserved
vrchat_notifications_recent and vrchat_status_page_overview — recent notifications, and VRChat's own up/down state with open and recent incidents
vrcx_db_status, vrcx_instances_recent, vrcx_gamelog_world_visits_recent, vrcx_user_relationship_summary and vrcx_user_relationship_sessions — your local VRCX history: worlds you visited, sessions you shared with someone, and time spent together
vrchat_read, vrchat_write and vrchat_delete — generated routers that reach VRChat API operations with no curated tool, addressed by operationId

Requirements

Node.js 24.15.0 or newer and an MCP client that can run a local stdio process; clients launch it with npx -y @basicbit/vrchat-mcp. You log in through vrchat_auth_begin, which opens a local browser flow — VRChat has no third-party OAuth, so this is a personal tool and not something to host. Cookies default to the OS keychain; set VRCHAT_MCP_COOKIE_STORE=file on headless Linux. VRCHAT_MCP_ALLOW_WRITES=false makes it read-only, and groups.allowlist in a JSON config restricts group writes to named group IDs.

Setup effort

One command — npx -y @basicbit/vrchat-mcp

See installation options

USE CASES

Seeing who is around right now

Summarise friends by status and location, then read the details of the one you want to join.

vrchat_friends_overviewvrchat_friend_details

Getting someone into your instance

Invite them to where you already are without looking up your own location first.

vrchat_invite_user_to_me

Finding something to do tonight

Look through public calendar events in the next few days and check the hosting group.

vrchat_events_upcomingvrchat_group_profile

Recalling how you know someone

Read your shared session history from local VRCX logs — time spent, join count and last seen.

vrcx_user_relationship_summaryvrcx_user_relationship_sessions

Running a group's event calendar

List the group's upcoming events and create or update the next one.

vrchat_group_events_upcomingvrchat_event_createvrchat_event_update

325 tools

Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.

`vrchat_auth_begin`

Begin login flow via local browser UI.

INSTALLATION

Connect your client

Server setup

TERMINAL

npx -y @basicbit/vrchat-mcp

MCP Clients

Claude Desktop, Cursor, Kiro, Other MCP clients

JSON

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

OpenCode

OPENCODE · JSON

{
  "mcp": {
    "vrchat": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@basicbit/vrchat-mcp"
      ],
      "enabled": true
    }
  }
}

VS Code

VS CODE · JSON

{
  "servers": {
    "vrchat": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@basicbit/vrchat-mcp"
      ]
    }
  }
}

VRChat MCP

Your own VRChat account, driven locally, with writes on by default and controls to turn them off.

What it is

What you get

Requirements

Setup effort

Seeing who is around right now

Getting someone into your instance

Finding something to do tonight

Recalling how you know someone

Running a group's event calendar

325 tools

vrchat_auth_begin

vrchat_auth_logout

vrchat_auth_status

vrchat_avatar_profile

vrchat_cache_invalidate

vrchat_config_get

vrchat_event_create

vrchat_event_delete

vrchat_event_follow

vrchat_event_update

vrchat_events_discover

vrchat_events_search

vrchat_events_upcoming

vrchat_friend_details

vrchat_friends_list

vrchat_friends_overview

vrchat_friends_search

vrchat_group_event_get

vrchat_group_event_next

vrchat_group_events_list

vrchat_group_events_upcoming

vrchat_group_instances_overview

vrchat_group_members

vrchat_group_posts_recent

vrchat_group_profile

vrchat_groups_search

vrchat_instance_create

vrchat_invite_self

vrchat_invite_user

vrchat_invite_user_to_me

vrchat_me

vrchat_notifications_recent

vrchat_profile_update

vrchat_read_checkUserExists

vrchat_read_checkUserPersistenceExists

vrchat_read_confirmEmail

vrchat_read_downloadFileVersion

vrchat_read_getActiveLicenses

vrchat_read_getActiveWorlds

vrchat_read_getAdminAssetBundle

vrchat_read_getAssignedPermissions

vrchat_read_getAvatar

vrchat_read_getAvatarStyles

vrchat_read_getBalance

vrchat_read_getBalanceEarnings

vrchat_read_getBlockedGroups

vrchat_read_getBulkGiftPurchases

vrchat_read_getCalendarEvents

vrchat_read_getContentAgreementStatus

vrchat_read_getCSS

vrchat_read_getCurrentOnlineUsers

vrchat_read_getCurrentSubscriptions

vrchat_read_getCurrentUser

vrchat_read_getEarningsMetrics

vrchat_read_getEconomyAccount

vrchat_read_getEconomyBalances

vrchat_read_getEconomyPayouts

vrchat_read_getEconomyPayoutStatus

vrchat_read_getFavoritedAvatars

vrchat_read_getFavoritedWorlds

vrchat_read_getFavoriteGroup

vrchat_read_getFavoriteGroups

vrchat_read_getFavoriteLimits

vrchat_read_getFavorites

vrchat_read_getFeaturedCalendarEvents

vrchat_read_getFile

vrchat_read_getFileAnalysis

vrchat_read_getFileAnalysisSecurity

`vrchat_auth_begin`

`vrchat_auth_logout`

`vrchat_auth_status`

`vrchat_avatar_profile`

`vrchat_cache_invalidate`

`vrchat_config_get`

`vrchat_event_create`

`vrchat_event_delete`

`vrchat_event_follow`

`vrchat_event_update`

`vrchat_events_discover`

`vrchat_events_search`

`vrchat_events_upcoming`

`vrchat_friend_details`

`vrchat_friends_list`

`vrchat_friends_overview`

`vrchat_friends_search`

`vrchat_group_event_get`

`vrchat_group_event_next`

`vrchat_group_events_list`

`vrchat_group_events_upcoming`

`vrchat_group_instances_overview`

`vrchat_group_members`

`vrchat_group_posts_recent`

`vrchat_group_profile`

`vrchat_groups_search`

`vrchat_instance_create`

`vrchat_invite_self`

`vrchat_invite_user`

`vrchat_invite_user_to_me`

`vrchat_me`

`vrchat_notifications_recent`

`vrchat_profile_update`

`vrchat_read_checkUserExists`

`vrchat_read_checkUserPersistenceExists`

`vrchat_read_confirmEmail`

`vrchat_read_downloadFileVersion`

`vrchat_read_getActiveLicenses`

`vrchat_read_getActiveWorlds`

`vrchat_read_getAdminAssetBundle`

`vrchat_read_getAssignedPermissions`

`vrchat_read_getAvatar`

`vrchat_read_getAvatarStyles`

`vrchat_read_getBalance`

`vrchat_read_getBalanceEarnings`

`vrchat_read_getBlockedGroups`

`vrchat_read_getBulkGiftPurchases`

`vrchat_read_getCalendarEvents`

`vrchat_read_getContentAgreementStatus`

`vrchat_read_getCSS`

`vrchat_read_getCurrentOnlineUsers`

`vrchat_read_getCurrentSubscriptions`

`vrchat_read_getCurrentUser`

`vrchat_read_getEarningsMetrics`

`vrchat_read_getEconomyAccount`

`vrchat_read_getEconomyBalances`

`vrchat_read_getEconomyPayouts`

`vrchat_read_getEconomyPayoutStatus`

`vrchat_read_getFavoritedAvatars`

`vrchat_read_getFavoritedWorlds`

`vrchat_read_getFavoriteGroup`

`vrchat_read_getFavoriteGroups`

`vrchat_read_getFavoriteLimits`

`vrchat_read_getFavorites`

`vrchat_read_getFeaturedCalendarEvents`

`vrchat_read_getFile`

`vrchat_read_getFileAnalysis`

`vrchat_read_getFileAnalysisSecurity`

`vrchat_read_getFileAnalysisStandard`

`vrchat_read_getFileDataUploadStatus`

`vrchat_read_getFiles`

`vrchat_read_getFollowedCalendarEvents`

`vrchat_read_getFriendStatus`

`vrchat_read_getGlobalAvatarModerations`

`vrchat_read_getGroupAuditLogEntryTypes`

`vrchat_read_getGroupAuditLogs`

`vrchat_read_getGroupBans`

`vrchat_read_getGroupCalendarEventICS`

`vrchat_read_getGroupGalleryImages`

`vrchat_read_getGroupInstances`