MojoPad can hand an AI assistant a set of tools for working with your wikis — so instead of you clicking around, you can just ask. Say “make a MojoPad wiki from the documents in this folder” and the assistant builds it; ask “what do my notes say about onboarding?” and it answers from your pages. As with everything in MojoPad, it all happens on your Mac; nothing about your wikis leaves your computer.
If words like MCP and agent are new to you, this chapter starts from zero. You don't need to be technical to use any of it.
MCP (the Model Context Protocol) is simply a shared standard for letting an AI assistant use tools. On its own, a chat assistant can only talk. MCP is the socket that lets it also do things in real apps — read a file, search a database, create a document. A program that offers such tools is called an MCP server; the assistant that uses them is the MCP client (or agent).
MojoPad includes an MCP server. Turning it on gives your assistant eleven MojoPad tools — create a wiki, add a page, search, ask a question, and so on. You never see the tools directly; you just talk to your assistant in plain language, and behind the scenes it picks the right MojoPad tool for what you asked. Think of it as teaching your AI assistant how to use MojoPad on your behalf.
Open Settings ▸ AI Agents (⌘,, then the AI Agents tab). You'll see a
button for each app. Click the one you use:
After connecting, confirm it worked: ask your assistant “check the MojoPad app status” or “list the pages in <some wiki>”. If it can answer, you're connected. From here on you never touch Settings again — you just talk to your assistant.
A concrete way to feel it working, in a fresh assistant session:
/path/to/that/folder, then open it in MojoPad.”That's the whole loop: you ask, the assistant uses MojoPad's tools, the result appears in the app. No wiki opens with setup questions — it's ready to use.
The tools fall into two groups. The offline group works directly with wiki files on disk — MojoPad doesn't even need to be running:
| You can say… | What happens |
|---|---|
| “Create a wiki at <path>” | Makes a new, empty .mojopad document. |
| “Fill it from the documents in <folder>” | Imports a folder: Markdown and text become editable pages, images are embedded, and PDFs, EPUBs, and Word files come in as attachments you can open and read in MojoPad. |
| “Add a page called X with this content…” | Writes a new page into a wiki. |
| “List / read / search the pages in <wiki>” | Browses a wiki's pages, reads one, or keyword-searches it. |
| “Open <wiki> in MojoPad” | Launches the app on that wiki. |
The live group works with the wiki you have open right now, using your local AI (these need the first switch below, and Ollama running):
| You can say… | What happens |
|---|---|
| “Ask my open wiki: <question>” | Answers from your own pages, and cites which pages it drew from. |
| “Search my open wiki by meaning for <idea>” | Finds related pages by meaning, not just matching words. |
| “Add a page to my open wiki…” | Writes a page that appears in the app as it's created (needs the second switch below). |
In Settings ▸ AI Agents there are two checkboxes. Both are off until you turn them on, and each unlocks a little more:
| Switch | What it allows | Turn it on when… |
|---|---|---|
| Let agents reach the wiki that's open right now | Unlocks the live features — Ask and search-by-meaning over your open wiki. The connection exists only on your own computer and is guarded by a private key, so a web page or another machine can't reach it. Nothing listens until you switch it on. | You want to ask questions of, or semantically search, the wiki you're working in. |
| Allow agents to modify wikis you already have | With this off, an assistant can create new wikis and read your existing ones, but not change them. On, it can also add pages to a wiki you already have, and fill an existing wiki from a folder. | You trust the assistant to write into wikis you already keep. |
A good default: leave both off to start. Creating new wikis and reading existing ones — the most common uses — needs neither. Turn on the first when you want to chat with your open wiki, and the second only when you want an assistant writing into wikis you already have.
Every part of this runs on your Mac. The offline tools read and write local files directly. The live Ask and semantic search use your local AI (Ollama) — your pages are never sent to any cloud. The live connection is local-only and key-guarded, so nothing outside your computer can reach your wikis through it. If you use no AI features at all, no connection is even opened.
claude
command and couldn't find it. Make sure Claude Code is installed, then try again — or use
Copy config and add MojoPad by hand.