What Marfa is

One home for your files, notes and records, on a machine you choose, that every app and agent you approve works from.

Marfa is one home, on a computer or server of your own, for everything you keep: your files and pictures, your notes and bookmarks, and what you keep in other services. Every app and agent you approve works from that one copy, and reaches only what you allow. Use it from Claude or ChatGPT, from the command line, or as a folder on your Mac, and keep your data when you change apps.

Marfa is early

Expect breaking changes until version 1.0. The Changelog lists each one.

What it looks like

On your phone, in Claude. You're reading about a hotel for a trip. You ask Claude to save the page and the PDF of its price list to Marfa, tagged lisbon. Back at your Mac, Claude Code finds both when you ask what you saved for the trip.

In a folder. Your files and pictures, and your notes as Markdown, are a folder on your computer, kept in step with Marfa. You open them in any app you like, and so can an agent. Drop a photo in and embed it in a note, and the photo is kept in Marfa as a file of its own, beside the note that shows it.

Across your agents. Codex, working in a project on your Mac, saves the receipts and contracts it finds to Marfa with the marfa command. Later you ask Claude, on the web, which ones are due for renewal, and it reads the same items. An agent you set up to summarize your reading holds a key that reads your bookmarks and writes notes, and sees nothing else.

How it fits together

One running Marfa is an instance. It belongs to one person, its owner, and keeps the one copy of their data that everything else works from. You and your apps reach it in these ways:

Keep a copy on the device
Swift SDK
An app you build for iPhone or Mac
Synced folder
Your files and notes as a folder
Call the instance
MCP server
Claude, ChatGPT, Claude Code, Codex
CLI
An agent that runs commands
HTTP API
A script you wrote
Your instance
On your Mac, or a host you choose
FilesNotesTasksBookmarks
Todoist connector
Tasks, both ways
Todoist
GitHub connector
Issues and pull requests
GitHub

Two of them keep a copy on the device, so they work offline and send their changes when they reach the instance again. A synced folder is one: your files and notes are a folder on your computer that you, or an agent, change in any app. An iPhone or Mac app built on the Swift SDK is the other.

The others call the instance directly. Claude, ChatGPT, Claude Code and Codex connect to its MCP server. The CLI, the marfa program, does everything from a terminal on any computer, and a script you write calls the HTTP API.

Connectors are programs you build from source and run yourself. Each copies records from a service such as Todoist or GitHub, and some carry your changes back. Every app, agent and connector uses a credential that you can see and revoke at any time.

If you know Apple's platforms, Marfa is like iCloud, but open to any app, and like HealthKit, but for any kind of data: each app asks for the kinds of things it needs and sees nothing else.

What Marfa isn't

  • Not for teams. Other people don't share or collaborate in your instance.
  • Not hosted for you. Your data lives on the machine you run Marfa on, and in any storage you choose to attach.
  • Not an app. You don't need any particular app, and anyone can build one on Marfa. You see your things through an agent, the CLI or a synced folder; the instance's own pages in your browser are only for setting up, signing in and approving access, and never show them.
  • Not a place to run code. Apps, agents and connectors run outside Marfa and reach it over its API.

Where it runs

Marfa runs on a Mac with Apple silicon, a Linux machine, or Railway, with no database server to set up. Your devices reach it on your own network, from anywhere over a private network such as Tailscale, or at a public address on your own domain, which Claude and ChatGPT need. Give your instance an address covers each.

Marfa is open source under the Apache License 2.0. The rules it follows are written down in the contract and checked by tests.

Planned

  • Marfa Cloud, a ready-made public address for your instance.
  • Apps built on Marfa for iPhone, iPad and Mac.

Choose your path

The Glossary defines the words these docs use.

On this page