Connect an assistant to MarkSay
The full instructions are already in the app — choose MarkSay ▸ Agent Access ▸ Set Up Agent… and they open as a document, matched to the version you are running.
There are two ways in, and you only need one. Try the first — it needs no download.
1. Paste the connection details (Claude Code, or anything with a shell)
In MarkSay, choose Agent Access ▸ Enable Agent Access, then
Copy Connection Information. Paste that into your assistant and say
you want it to use MarkSay. The clipboard carries the base URL, the MCP
endpoint, the bearer token, and the address of MarkSay's own contract at
http://127.0.0.1:<port>/v1/openapi.json — so the assistant
can read what MarkSay offers rather than be taught it. That is the whole
setup.
An MCP host that takes a URL is the same paste by hand: point it at the MCP
endpoint with the token as an Authorization header. The port
changes each time MarkSay starts, so copy the connection information again
after a restart.
2. Install the extension (Claude Desktop)
Claude Desktop does not take a URL, so it connects through a small extension instead. This is the one thing MarkSay cannot ship inside itself, and the reason this page exists.
Download marksay.mcpb — version 1.0.1
Open the downloaded file and Claude Desktop will offer to install it. The extension is a small pipe between Claude Desktop and MarkSay: it declares no tools of its own, so what you see is whatever MarkSay itself offers, and it can do nothing MarkSay would not already do for the request.
Two things it cannot do for you. MarkSay has to be running, and Agent Access has to be enabled — that is what writes the pairing file the extension reads for the address and token. If either is missing, it says so rather than failing quietly.
It requires Node 18 or newer, and runs only on macOS.
What an assistant can do
Free. List the documents you have open and read any of them — content, revision, and your current selection.
MarkSay Agent. Everything that acts on the app: create a document, replace or append text, replace an exact range, open a file inside a folder you have authorized, save, reveal a place in a document so you are looking at what it is describing, and export to HTML, PDF, or Word at a path inside an authorized folder — rendered on your Mac, diagrams and math as vector SVG, with no tokens spent and nothing fetched. Edits are revision-checked and each is a single Undo. There is a 14-day trial, then a one-time unlock.
Without Agent, those requests are refused with a message saying so. Reading keeps working, and your own editing is never affected.
Nothing leaves your Mac
Agent Access listens on 127.0.0.1 only — the loopback
interface, which nothing outside your Mac can reach. There is no account, no
cloud service, and no network hop beyond loopback. If you think a token has
leaked, Rotate Token replaces it immediately.