Help › Projects & Data
All help topics
AI connections (Claude Code, Codex, LM Studio and more)
Let Claude Code, Codex, LM Studio or any other AI app on your Mac that supports MCP read your project, add cards and build HTML pages inside it.


WriterMorph has no AI of its own. You can let an AI app on your Mac work in the project that is open in WriterMorph: Claude Code, Codex, LM Studio or any other AI app that supports MCP, whatever the brand. It works with the same cards you do: it can draft new cards, fill in their properties, write and revise text, reorganize the binder, build HTML pages as tabs, search the project and compile it.
AI Connections is part of WriterMorph for Mac. The iPad app does not include it.
The connection is off by default and nothing runs while WriterMorph is closed.
Turn it on
- Open Settings (⌘,) and choose AI Connections.
- Switch on Turn on AI Connections.
- Under What AI apps may do, leave Allow changes off if you only want the assistant to read. Turn it on to let it add and edit cards and tabs.
- Allow deleting is a separate switch. Deleted cards and tabs go to the Trash.
A badge at the top of the pane shows the status: Off, On · waiting for an app, or Connected: with the names of the connected apps, such as Claude Code or LM Studio.
Connect your AI app (one time)
WriterMorph works with any AI app on your Mac that can use an MCP server, whatever the brand. Pick yours below. Each one needs WriterMorph's address and your secret key; for Claude Code and Codex, WriterMorph puts both into a setup command for you, and for LM Studio into a one-click link.
Claude Code (Anthropic) or Codex (OpenAI)
- Install the app if it isn't on your Mac yet. It uses your own Claude or ChatGPT account.
- In Settings › AI Connections, under Connect an app (one time), choose Claude Code or Codex and click Copy & Open Terminal.
- Click in the Terminal window, press ⌘V, then Return.
- Type
claude(orcodex) and press Return. Then ask in plain words, for example: "List the tabs in my open WriterMorph project."
The row below the steps turns green and says the app is connected. To check in Terminal, run claude mcp list (or codex mcp list).
LM Studio: local AI, nothing leaves your Mac
- Install LM Studio (version 0.3.17 or later) and download a model that can use tools.
- In Settings › AI Connections, under Connect an app (one time), choose LM Studio and click Add to LM Studio. LM Studio opens with WriterMorph ready to add. If it asks, click Install.
- Start a new chat, choose the model and ask in plain words.
To add WriterMorph by hand instead, open the Program tab in LM Studio's right-hand sidebar and choose Install › Edit mcp.json. Add WriterMorph with your own key, then save:
{
"mcpServers": {
"writermorph": {
"url": "http://127.0.0.1:47821/mcp",
"headers": { "Authorization": "Bearer YOUR-KEY" }
}
}
}
If the file already lists other servers, add only the "writermorph" part inside "mcpServers".
Other AI apps, any brand
Any app that can connect to an MCP server over HTTP works, for example Msty Studio, Cherry Studio, Jan or Cline. In Settings › AI Connections, under Connect an app (one time), choose Other Apps: WriterMorph shows its address and your key, each with a button to copy it. Then, in the app's MCP settings (sometimes called Tools or Connectors), add a server:
- Type: HTTP (Streamable HTTP)
- Name: writermorph
- Address (URL):
http://127.0.0.1:47821/mcp - Header:
Authorization, with the valueBearer YOUR-KEY
If the app asks for JSON, click Copy JSON: it is the same entry as for LM Studio. Then choose a model that can use tools and ask in plain words.
For example, Grok
Grok (xAI) connects the same way as any other app. There are three ways to use it:
- Grok Build, xAI's app for Terminal. Install it from xAI's Grok Build page and sign in. Then run this command once in Terminal, with your own key in place of YOUR-KEY:
Typegrok mcp add --transport http writermorph http://127.0.0.1:47821/mcp --header "Authorization: Bearer YOUR-KEY"grok, press Return and ask in plain words. - Grok in a desktop chat app, such as Msty Studio, Cherry Studio, Jan or Cline. Add your xAI API key in that app, then add WriterMorph as an MCP server, as described under Other AI apps.
- grok.com, the Grok apps and Grok Bot run in xAI's cloud. They can't reach WriterMorph, because WriterMorph only accepts connections from your own Mac.
Where to find your key
In Settings › AI Connections, click Show Command, then Show Key. Your key is the long text after Bearer. It works like a password: don't share it or post it online.
If an app stops connecting
This usually happens after Create New Key…: the app still has the old key. Set it up again with the new key:
- Claude Code: in Terminal, run
claude mcp remove --scope user writermorph. Then click Copy & Open Terminal again, press ⌘V, then Return. - Codex: click Copy & Open Terminal again. The command replaces the old setup.
- Grok Build: run
grok mcp remove writermorph, then thegrok mcp addcommand above with the new key. - LM Studio and other apps: replace the key in their settings.
AI apps connect when a session starts, so start a new session afterwards. In Claude Code you can also type /mcp, choose writermorph and then Reconnect.
Disconnect an app
Under Connected apps, click Disconnect… next to the app. WriterMorph copies the remove command and opens Terminal: press ⌘V, then Return, then click Done. For LM Studio and other apps, remove the writermorph server in that app's MCP settings, then click Remove from List. To pause every app at once, turn off AI Connections instead.
Active Services
While AI Connections or a Labs feature is on, a small Active Services indicator shows in the top bar and on the Home screen: a colored dot with the connected app, and how many Labs features are on.
Click it to open the Active Services window. There you can turn AI Connections on or off, change Allow changes and Allow deleting, see the connected apps and What AI apps did (the latest 40 actions since WriterMorph opened), and turn the Labs features on or off.
Things to ask for
Planning and properties
- "Plan this premise as a three-act novel: acts, six scenes, the cast and places."
- "Fill in point of view, beat, tension and place for every scene in Act II."
- "Mark all four Chapter 5 sections as Draft and set each target to 900 words."
- "Give every scene a story date and time, and mark the flashbacks."
- "Turn the sections of this document into cards under Chapter 3."
- "Write a two-line summary for every card that has none."
Pages inside the project
- "Make a tabbed HTML page from this document and open it in a new tab."
- "Make a character dossier: the cast, who shares scenes with whom, a scene-by-scene chart and each arc."
- "Map my literature review: sources by theme and year, where each is cited, and anything I haven't cited."
- "Build a story bible with tabs for characters, places and chronology."
- "Turn Chapter 2 into a study page with flashcards and a self-quiz."
- "Make a results dashboard from Table 4.1."
Databases, data tables and more
- "Make a Sources database with Author, Year, URL and Status, and add the books in this list."
- "Give every character a Faction relation to the Factions database."
- "Put Mara's inventory in a data table: item, quantity and where she found it."
- "Attach the museum's web page to the Harbor card."
- "Move the Act III cards to the planner called Drafts."
To see and edit databases yourself, turn on Settings › Labs › Databases. See Databases and data cards.
HTML pages
When you ask for a page, report or dashboard, the assistant creates a new HTML tab in the project. These pages:
- follow WriterMorph's light or dark setting,
- have zoom and full-width controls in their header,
- remember their inner tab and zoom,
- are saved inside the
.wmorphproject file, so they travel with it.
The HTML tab shows the source code beside the live page, and you can edit the source.
You can also ask for a Live Page in the same style as WriterMorph's templates, such as a tracker for a book club or a dashboard for a grant application. WriterMorph gives the assistant a Live Page Designer skill: it starts from the closest of the 48 built-in templates, reads its source and builds a page with the same look and controls for what you asked.
Safety
- The connection only accepts requests from your own Mac and needs a private key. Create New Key… under Security replaces the key; the old setup command stops working.
- Changes from the assistant can be undone with ⌘Z.
- Recent activity lists what the assistant did.
- What the assistant sends to its own service is covered by that provider's terms. WriterMorph itself sends nothing.
Going back to before an AI edit
Before an assistant changes an HTML page, a note or a document, WriterMorph keeps a copy of how it was.
- For an HTML page, choose File ▾ › Restore Before AI Edit ▸ in the tab's header and pick a version.
- For a note or a document, click the clock button in its header.
Restoring keeps a copy of the current content too, so you can change your mind again. Card changes in a planner are undone with Edit › Undo, as always.