Filamental and LM Studio

The model on your desk, the files on your disk, and nothing in between

LM Studio has been an MCP host since 0.3.17, so it can reach a Filamental space the same way Claude does. The difference is what the arrangement adds up to: a model running on your own hardware, working on Markdown files in your own folder, through an application with no account and no telemetry. Nothing leaves.

Why this pairing in particular

Running the model locally is the easy half

Anybody who has gone to the trouble of running a model on their own hardware has usually done it for a reason that survives scrutiny: work under an NDA, a client’s material, a case, an investigation, or an employer whose policy is simply no. Then the notes go into a note-taking service, the structure goes into a cloud tool, and the careful part of the arrangement is undone by the boring part of it.

Filamental is the third leg. There is no account to create, no server holding your work and no telemetry of any kind, and your space is Markdown files in a folder you chose. Point LM Studio at it and every element of the arrangement is on the same machine, which is a sentence you can put in front of a client or a security review without qualifying it.

It is also worth saying what this is not. There is no offline mode to switch on, because nothing is online to begin with.

Connecting it

The same entry the other MCP clients use

Add Filamental to LM Studio’s mcp.json as an entry named filamental, running node against the bundled server with your space folder passed after a --vault argument:

{
  "mcpServers": {
    "filamental": {
      "command": "node",
      "args": [
        "--no-warnings",
        "/absolute/path/to/filamental-mcp/dist/index.js",
        "--vault",
        "/absolute/path/to/your/vault"
      ]
    }
  }
}

Copy both absolute paths from Settings, then AI Integrations, then Manual setup inside Filamental. You need LM Studio 0.3.17 or later, Node.js 22 or later, and Filamental v0.2.4 or later, on Windows, macOS or Linux.

One prerequisite, and it is the only one that catches people out. The server reads the index Filamental builds and never builds one itself, so the space has to have been opened in the application at least once on that machine. A folder it has not seen stops with a message saying exactly that. If reading a folder somebody sent you is what you want, point the AI at the files directly instead, since a space is plain Markdown and no index is involved.

What the model can then do is exactly what any other client can do: search the space, read notes and properties, follow connections in both directions, create and edit nodes, draw typed connections, and define whole category and connector vocabularies. The connection does not know or care where the model is running.

The part nobody tells you

The protocol working is not the same as the arrangement working well

Building a structure through MCP means calling tools accurately and repeatedly: create this node, give it that type, connect it to the other one in this direction, then do it forty more times without losing the thread. Small models vary enormously at exactly that, and a model that holds a perfectly good conversation about your project can still make a mess of building it.

So try it on a small project first, with something you would not mind rebuilding. If the tool calls come back malformed or the model forgets what it has already created, the honest fix is a more capable model rather than a different configuration, and no amount of prompting will get you round it.

When a local model is not up to authoring, it is often still perfectly good at reading. A structure you built by hand, or with a cloud model, can be interrogated locally afterwards, which keeps the confidential half of the work on the confidential half of the setup.

What we tell your AI

You can read the exact text your model is handed

A short briefing arrives when the connection opens, covering what nodes, categories and connectors are and the conventions that keep a structure readable, and the full skill guide and file format specification are pulled on demand only when a task needs them. That layering matters more with a local model than a frontier one, since a small context window is not something to spend on documentation the job does not need.

Both documents are published on this website word for word as they are sent: the skill file and the file format reference. Nothing else runs underneath them, and the MCP server has no network access of its own.

What it costs

Nothing, and there is nothing of ours to meter it at

Free on the Personal plan, which is free permanently with no account and no card, and not credited, seat-limited or reserved for a better tier. The paid tier is $120 a year and buys sending a finished structure to somebody who does not have the application, encrypted on your machine before it reaches us, so we cannot read it either.

If the reason you run models locally is the work rather than the hardware, the In practice pages are written for the fields where that is usually the case.

Asked before connecting

Six straight answers

How do I connect LM Studio to Filamental?

LM Studio has acted as an MCP host since version 0.3.17, so you add Filamental to its mcp.json as an entry named filamental, running node against the bundled server with your space folder passed after a --vault argument. Copy both absolute paths from Settings, then AI Integrations, then Manual setup inside Filamental. It is the same configuration used by Claude Code and Cursor.

Does anything at all leave my machine with this setup?

No, and that is the reason to use this combination rather than any other on the site. The model runs on your own hardware in LM Studio, the MCP server is a local process, and your space is Markdown files in a folder on your own disk. Filamental has no account, no sign-in and no telemetry of any kind, so there is no channel for anything to leave by even if somebody wanted one.

Will a small local model actually be able to build a structure?

Some will and some will not, and it is worth knowing that before you judge the connection. The protocol working is not the same as the arrangement working well, because building a structure means calling tools accurately and repeatedly, and small models vary enormously at exactly that. Try it on a small project first, and if the tool calls are unreliable the honest fix is a more capable model rather than a different configuration.

What can the local model do to my space once it is connected?

The same as any other MCP client. It can search nodes, read their notes and properties, follow connections in both directions, create and edit nodes, draw typed connections and define whole category and connector vocabularies. The reach is identical whether the model is running on your desk or in somebody else's data centre, since the connection does not know or care which.

Can I paste a local model's address into Filamental's own AI window instead?

Not today. Filamental's built-in chat window identifies a provider from the API key you paste and resolves the endpoint itself, so there is no field for a custom or local address, and the sixteen providers it recognises are all remote ones. MCP is the supported route to a local model, which is what this page describes. If a local endpoint in the chat window would be useful to you, tell us, because that is exactly the sort of request that decides what gets built.

Is Open WebUI supported in the same way?

Not directly. Open WebUI's MCP support is HTTP-only by design, since it runs as a web application rather than a local process, and Filamental's server talks over stdio. It can be bridged with a proxy such as mcpo, but that is a self-assembly job and we do not support it. LM Studio is the local host we would point you at instead.

A first thing to try

Give it the one piece of work you would never put in a cloud tool

That is the case this arrangement exists for, and it is the only test that tells you anything. Free to build in, no account, no card, and nothing that leaves the machine.

Version
0.3.42
Platforms
Win / macOS / Linux
Personal
Free, permanent
Professional
$120 / year