In the documentation A local model (Ollama)
Developers and agents
A local model on your documents (Ollama)
A model running on your computer, with Ollama, reads and adds to a document open in the Paginel Text desktop app. The model, your MCP client, Paginel’s MCP server and the document stay on the computer: nothing goes online. It is made for small tasks: adding a task to a list, a note at the end of a document, a comment.
What you need
- The Paginel Text desktop app, version 0.3.0 or later (see Download). The MCP server is inside the app: nothing else to install from us.
- Ollama, installed on the computer (ollama.com).
- A model that can call tools. We tried
gemma4:e4b(9.6 GB), on a computer with a 12 GB graphics card: the requests below succeeded in a few seconds.qwen3:4b, smaller (2.5 GB), adds a task well but corrects a text poorly. - An MCP client: the program where you talk to the model, if it can use an Ollama model and MCP servers. We tried ollmcp and Hermes Agent.
Once: the model and your client
- Install Ollama, then download the model:
ollama pull gemma4:e4b. - In your MCP client, choose this Ollama model: with ollmcp,
ollmcp -m gemma4:e4b; with Hermes Agent, in~/.hermes/config.yaml, thecustomprovider athttp://127.0.0.1:11434/v1.
For each document: give it to the model
- In Paginel Text, open the file: File › Open a Word or Markdown file…
- Insert › Agent, then Local agent. For a single section: right-click its heading, Connect an agent to this section…
- Choose what it may do: Read-only, Editing · Assigned sections or Editing · Whole document.
- Under “A model on this computer (Ollama…)?”, click Copy the MCP configuration: the model is given this document, and the configuration is copied.
The button copies this block. The first time, paste it into your MCP client, where it lists its MCP servers. It is the same for all your documents: for the next ones, the button is enough, nothing to paste.
MCP configuration{ "mcpServers": { "paginel_local": { "command": "(path to Paginel Text)", "args": [ "--mcp" ] } }} Ask it
In your client, just ask. With a small model, short and precise requests work best:
- “Add the task ‘Review the budget’ to the task list.”
- “Add a note at the end of the document: the meeting moves to Thursday.”
- “Comment on the Budget section: the cost of the licenses is missing.”
What it does
It reads the document, or a single section. Then, where you allow it, it fixes a passage, rewrites a section, adds text at the end of a section or of the document, comments on a passage or a section.
Its changes show up in the window, signed with its name, and can be undone in the history, like yours. The file on disk changes only when you save.
What it does not do
- Read or write the file on disk: it goes through Paginel, so through the history, and you are the one who saves.
- Open any document other than those you give it.
- Talk to another machine: Paginel’s MCP server opens no port; only your client, which starts it, talks to it, and it talks only to Paginel, on this computer.
- Delete or rename the document.
See and cut its access
Among the document’s people, at the top right, the Local agent entry shows that the access exists: waiting as long as the model has asked nothing, then connected, under its name.
A click on the entry tells what it may do and who worked here; Cut the access disconnects it, right away, like the small cross on the entry. Closing the document’s window, or quitting Paginel, cuts its access too; to connect it again, Copy the MCP configuration once more, nothing to paste.
For developers
text-desktop --mcp --check, with the app’s path written in the configuration, says what the MCP server sees: where Paginel is, the documents given to it, and whether they answer. It is the command to run if the model finds nothing.
For a Paginel document server running on this computer (tests, scripts), the same MCP server exists on its own: paginel-local-mcp --server http://127.0.0.1:8787. --doc limits it to one document, --agent gives it the agent’s name, which must be registered in the document to write. It refuses any address that is not this computer’s. It is not in the downloads: write to us.
Going further
- How Paginel works The app, the server, and how your changes travel, without jargon.
- Get started Create an account, open a Word or Markdown file, find your documents.
- Invite and share Invite with a link or a code, choose how long it lasts, remove access.
- Connect Claude or ChatGPT In three steps: Claude or ChatGPT in your documents, and how to remove its access.
- Write in Markdown The Markdown view, the useful syntax, pasting Markdown, agents.
- Take notes in the Web view A clean page without a sheet, where typed Markdown formats itself.
- Format in the Edit view Styles, font and size, images, comments, and the Word file.
- Export to PDF The PDF view, downloading, PDF/A for archiving.
- Data management Where your documents are, who can read them, how to take them back and erase them.
- The Paginel connector (MCP) The connector in detail: Claude, ChatGPT, Claude Code, the authorization, the agent mode.
- API tokens Give an agent (Claude Code, a script) access to a document, a folder or a section: rights, expiry, SKILL, security.
- VS Code extension Your Markdown and Word files in VS Code, the PDF, a synced Markdown file for your agents.
- Help The questions we are asked most.