# 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](/changelog) lists each one.

## What it looks like [#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 [#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:



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](/use/sync-a-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](/reference/swift-sdk) is the other.

The others **call the instance directly**. Claude, ChatGPT, Claude Code and Codex connect to its [MCP server](/reference/marfa-mcp-server). The [CLI](/reference/cli), the `marfa` program, does everything from a terminal on any computer, and a script you write calls the [HTTP API](/reference/api).

[Connectors](/use/connect-a-service) 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](/use/see-and-cut-access) 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 [#what-marfa-isnt]

* **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 [#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](/run/address) covers each.

Marfa is open source under the Apache License 2.0. The rules it follows are written down in [the contract](https://github.com/withmarfa/marfa/tree/main/conformance/spec) and checked by tests.

## Planned [#planned]

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

## Choose your path [#choose-your-path]

- [Start Marfa](/quickstart): Install Marfa on your computer, connect an agent, and save and find your first file.

- [Connect your agent](/connect-your-agent): Give Claude, ChatGPT, Claude Code or Codex your data, with only the access you choose.

- [Learn the ideas](/how-marfa-works): Items, types, tags, edges, the library and the feed, in a few minutes.

- [Build on it](/build/architecture): Write an app, a script or a connector that reads and writes your items.

The [Glossary](/glossary) defines the words these docs use.
