imbue
Docs pages

Docs / For developers

The Worlds MCP server

Worlds comes with an MCP server that lets Claude Code, or any other program that speaks MCP, read and edit your pages on your computer, with the same safe tools the in-app assistant uses. A version is saved before every write, and every write can be undone.

What it is

MCP is a standard way for AI programs to connect to tools. The Worlds server is the Worlds app itself running in a special mode: worlds.exe --mcp. It talks to the program over standard input and output on your computer and opens the local Worlds database directly. Nothing goes over the internet or through Worlds servers.

The server is available in the Windows app.

Connecting Claude Code

From inside Worlds (easiest)

  1. Open Settings, Claude

    In the Claude Code group there is a row, "Use Worlds from Claude Code sessions".

  2. Click Register

    Worlds adds its tool server to your Claude Code user configuration. You see "Worlds tools registered with Claude Code". The button is off if Worlds cannot find Claude Code on the PC.

  3. Start a new Claude Code session

    Now "Your Claude Code sessions can read and edit pages through the same safe tools." The Integrations view shows "Also available in your Claude Code sessions".

If you move or reinstall Worlds, click Register again.

With the command

This is the command the Register button runs. The path is where Worlds usually installs on Windows. If you installed it somewhere else, use the path to your worlds.exe:

claude mcp add --scope user worlds -- "%LOCALAPPDATA%\Worlds\worlds.exe" --mcp --actor ai

--scope user makes the tools available in all your projects. --actor ai records changes as made by AI in the Worlds history, so you can tell who changed what.

Other MCP clients

Any program that runs a local MCP server over standard input and output needs a command and arguments:

Command
%LOCALAPPDATA%\Worlds\worlds.exe (or your install path)
Arguments
--mcp --actor ai
Type
stdio

In the format most programs use:

{
  "mcpServers": {
    "worlds": {
      "type": "stdio",
      "command": "C:\\Users\\YOU\\AppData\\Local\\Worlds\\worlds.exe",
      "args": ["--mcp", "--actor", "ai"]
    }
  }
}

Codex inside Worlds (from Settings, Providers) gets the Worlds tools automatically. Worlds has no button that registers the server with the Codex you use outside the app, so add it with the command and arguments above.

Which workspace it uses

The server opens the Worlds database on your computer: %APPDATA%\Worlds\worlds.db. If the WORLDS_DATA_DIR environment variable is set, it uses that folder instead. The Worlds app sees changes the server makes and refreshes open pages.

Tool groups

GroupWhat it doesExamples
PagesCreate, read, search, rename, move, archive, restore and export to Markdownpages_create, pages_read, pages_search
BlocksInsert, update, move, convert and delete blocksblocks_insert, blocks_update
TablesRead a table, add a row, update a cell, import and export CSVtables_read, tables_from_csv
DrawingsRead a drawing and apply changes to it, its versions, and the drawing librarydrawings_read, drawings_apply
PresentationsRead a deck, add a slide and update itpresentations_add_slide
Tasks, properties and collectionsTasks, and page properties and their optionstasks_add, properties_schema
AutomationsList, create, update and run, the run history and upcoming runsautomations_create, automations_runs
DiscordList destinations, preview a message, request a send or edit, see what is pending and what was sentdiscord_preview, discord_send
TemplatesList templates, make a page from one or a template from a pagetemplates_instantiate
History and versionsRead the history, undo, list, compare and restore versionshistory_undo, versions_restore
ProfileName, status, links, images and blocksprofile_update
Media and filesAttach files and add them to pages and galleriesattachments_add
Chats and instructionsEarlier Claude chats, and the global instructionschats_search, instructions_read
GeneralWorkspace overview, search everything, the time, settings, an activity summary, Trash and archiveworkspace_overview, search_everything

Two more groups come in a coming release:

Safety and undo

Discord sends wait for your approval

discord_send, discord_edit and automations_run send nothing. They put the request in Needs approval in the Worlds Activity view, and the server replies that nothing was sent and the request waits for your approval. An automation that a program creates through MCP is always saved to wait for approval before each send. To approve, the Worlds app must be open. See The approval queue.

Read next