VRChat Assistant: MCP tool for Hermes Agent

Self-hosted VRChat friend monitor that exposes an MCP toolset for AI agents such as Hermes

What VRChat Assistant does

VRChat Assistant is a resident Node.js service that watches your VRChat friends in real time over a WebSocket and stores their online and offline events, world changes, avatar changes and status changes in a local SQLite database. It exposes everything through MCP so an AI agent such as Hermes can look up friends, recommend rooms, search worlds and BOOTH assets, send boops and invites, manage VRC+ photos and groups, and produce a weekly gaming report.

The service reconnects automatically and can log in unattended by fetching email OTP codes over IMAP or by using a TOTP secret. Functionality is split between core tools and official plugins such as booth, groups, media, recommend and world-kb, and a skills folder documents the MCP tools and query workflows. The database is backed up automatically every 24 hours, and a Hermes plugin can launch the service and restart it after a crash. The project describes itself as AI-first, with READMEs in Chinese, English and Japanese.

Key features

Real-time friend tracking: online status, world changes, avatar changes and status text
MCP tools for friend queries, social actions, media, groups, world search and BOOTH asset search
Unattended login using email OTP over IMAP or a TOTP secret, with automatic reconnect
Friend and room recommendations, and a weekly gaming report
Plugin architecture with official plugins and a bundled skills collection
Automatic 24-hour database backup and Hermes plugin hosting with crash recovery

When to use it

Asking Hermes which friends are online and which room is worth joining
Finding new VRChat worlds or BOOTH avatar assets through an agent
Reviewing a weekly report of your own and your friends' play patterns

Who it is for: VRChat users who run an AI agent such as Hermes and want it to monitor friends and handle social and media tasks.

How it fits with Hermes Agent

Built with Hermes in mind: the README names Hermes as the example agent for its MCP interface, and a Hermes plugin can host the service with automatic start and crash recovery.

How to install VRChat Assistant

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

npm install
npm run install-plugins
node start-monitor.js
curl http://127.0.0.1:8799/health

Requirements: Node.js 22 or later, a VRChat account with email OTP or TOTP two-factor authentication, and an IMAP-capable mailbox only if you use email OTP login

FAQ

What is VRChat Assistant?

VRChat Assistant is a self-hosted service that collects your VRChat friends' activity into a local database and exposes it, with many VRChat actions, as MCP tools for AI agents.

Does VRChat Assistant work with Hermes Agent?

Yes. The README uses Hermes as its example agent for the MCP interface, and a Hermes plugin can launch the service and recover it after crashes. It also ships agent skills documenting the tools.

What do I need to run VRChat Assistant?

You need Node.js 22 or later and a VRChat account with email OTP or TOTP two-factor authentication. An IMAP-capable mailbox is needed only for email OTP login.