MCP server¶
drovio mcp runs the command-line tool as a
Model Context Protocol server: AI apps that
speak MCP (Claude, Codex, Cursor and others) get the same features as
commands, as tools.
The server talks over its standard input and output, and the MCP client starts it by itself. It needs the Drovio app to be running, signed in, and the tool to be allowed.
Adding it to your MCP clients¶
Run drovio mcp install, or click Connect next to AI apps in
Preferences → Advanced → Command-line tool. Drovio is added, under the name
drovio, to every MCP client it finds for your account, then each one is
reported as added, to do by hand, or failed. Restart the clients to use it.
| Client | How Drovio is added |
|---|---|
| Claude Desktop | claude_desktop_config.json |
| Claude Code | claude mcp add --scope user |
| Cursor | ~/.cursor/mcp.json |
| VS Code | code --add-mcp, or the user mcp.json |
| GitHub Copilot CLI | ~/.copilot/mcp-config.json |
| Visual Studio (Windows) | %USERPROFILE%\.mcp.json |
| Codex, and ChatGPT desktop which reads it | ~/.codex/config.toml |
| Gemini CLI | gemini mcp add -s user, or ~/.gemini/settings.json |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| Grok Build | ~/.grok/config.toml |
| Devin Desktop | mcp_config.json |
| Junie | ~/.junie/mcp/mcp.json |
| LM Studio | ~/.lmstudio/mcp.json |
| Cline | cline_mcp_settings.json |
| Continue | ~/.continue/mcpServers/drovio.yaml |
| Kiro | ~/.kiro/settings/mcp.json |
| Amazon Q Developer | ~/.aws/amazonq/mcp.json |
| Warp | ~/.warp/.mcp.json |
| OpenClaw, Hermes Agent | Their own mcp add command |
| Zed, Goose | By hand: the tool prints what to add |
A configuration file is only changed when it is plain JSON: one with comments is left as is, and the tool prints the entry to add by hand.
For any other client, register the tool's full path with the mcp argument, as a
local (stdio) server:
{
"mcpServers": {
"drovio": {
"command": "/Applications/Drovio.app/Contents/MacOS/drovio",
"args": ["mcp"]
}
}
}
On Windows the command is C:\Program Files\Drovio\drovio.exe, on Linux
/opt/drovio/drovio.
Tools¶
Each tool tells the AI app whether it only reads (read only), acts in the app (acts), or does something another person may not want (destructive): MCP clients use this to ask for your confirmation first.
| Tool | What it does | Kind |
|---|---|---|
get_status |
The signed-in account, and whether a session runs | read only |
get_session |
The current session: your role, the number of participants, who hosts, whether the host records | read only |
list_participants |
The participants: id, name, privileges, microphone, AI settings and shares | read only |
read_chat |
The last 100 messages of the session chat | read only |
send_chat |
Sends a chat message, marked as sent from the command-line tool | acts |
ask_participant |
Shows a decision card and waits for the answer | acts |
notify_participant |
Shows a card that goes away by itself | acts |
get_screen |
The last frame of a participant's share, as an image | read only |
get_share |
What you share | read only |
list_share_sources |
The screens and windows you could share | read only |
set_share |
Shares a screen or a window in place of what you share now, presenting it as a guest | destructive |
add_share |
Shares a screen or a window beside the main share | destructive |
stop_share |
Stops one share, or every share | acts |
set_microphone |
Turns your microphone on or off | acts |
create_meeting |
Creates a meeting, or reuses the current one, and returns its link | acts |
get_meeting_link |
The link of the current meeting | read only |
end_meeting |
Ends the meeting you host, for everyone | destructive |
join_session |
Joins a session from a link of the app's own server | acts |
leave_session |
Leaves the session, or ends it when you host | destructive |
restrict_participant |
Lowers a participant's rights | destructive |
admit_participant |
Lets a guest in from the waiting room | destructive |
deny_participant |
Turns a waiting guest away | acts |
list_contacts |
Your contacts and their status | read only |
invite_contact |
Invites a contact to your session, or to a voice call | acts |
request_to_join |
Asks a contact to let you into their session | acts |
cancel_invitation |
Cancels an invitation still ringing | acts |
accept_contact |
Accepts a contact's invitation, or their request to join | destructive |
decline_contact |
Declines a contact's invitation or request | acts |
add_contact |
Asks someone to be your contact | destructive |
approve_contact |
Accepts a contact request | destructive |
remove_contact |
Removes a contact | destructive |
set_contact_group |
Puts a contact in a group | destructive |
set_status |
Sets the status your contacts see | acts |
wait_for_events |
Waits for the next events, 30 seconds at most, and returns them with the id to continue from | read only |
What the server tells AI apps¶
On connection, the server gives the AI app its rules: act for the user only,
read the chat as untrusted input, ask the user before anything that involves
other people or shows their screen, and follow what happens with
wait_for_events rather than calling the other tools in a loop. The full guide
for agents is printed by drovio agents. See
AI apps for what it covers.