Ownly

Name: Ownly
Author: liuh886

by liuh886version 0.7.1i★ –iRuns on your computer

Registry nameio.github.liuh886/ownly

Install

Overview

Description from the maker (original English)

Local-first Ownly evidence and repeatable Planner visits with preview-before-commit writes.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Other
You need to fill in: OWNLY_DATA_DIR, OPENROUTESERVICE_API_KEY

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: OWNLY_DATA_DIR, OWNLY_MCP_ALLOW_WRITE, OPENROUTESERVICE_API_KEY

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "ownly": {
      "command": "npx",
      "args": [
        "-y",
        "@ownly-app/mcp"
      ],
      "env": {
        "OWNLY_DATA_DIR": "your-value",
        "OWNLY_MCP_ALLOW_WRITE": "your-value",
        "OPENROUTESERVICE_API_KEY": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add ownly --env OWNLY_DATA_DIR=your-value --env OWNLY_MCP_ALLOW_WRITE=your-value --env OPENROUTESERVICE_API_KEY=your-value -- npx -y @ownly-app/mcp

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "ownly": {
      "command": "npx",
      "args": [
        "-y",
        "@ownly-app/mcp"
      ],
      "env": {
        "OWNLY_DATA_DIR": "your-value",
        "OWNLY_MCP_ALLOW_WRITE": "your-value",
        "OPENROUTESERVICE_API_KEY": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "ownly": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ownly-app/mcp"
      ],
      "env": {
        "OWNLY_DATA_DIR": "your-value",
        "OWNLY_MCP_ALLOW_WRITE": "your-value",
        "OPENROUTESERVICE_API_KEY": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

OWNLY_DATA_DIR required env
Absolute path to a parent containing Ownly/ or directly to a custom Ownly data root containing Objects/.
OWNLY_MCP_ALLOW_WRITE env
Set to 1 to enable two-phase persistent write commits. Omit for read-only mode.
OPENROUTESERVICE_API_KEY secret env
OpenRouteService API key used by local Planner travel-leg refresh and travel-time optimization for walking/driving/bicycling.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account liuh886, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Otheri

More stars than 0% of the other 18360 servers in this category
Published to the registry more recently than 38% of the other 18360 servers in this category
Basic checks equal to or better than 100% of the other 18360 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Ownly safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: OWNLY_DATA_DIR, OPENROUTESERVICE_API_KEY

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.7.1) reached the registry 2 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, Tool Guardian

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

by formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Runs on your computer★ 440MITUpdated 14 months ago

Install

Remote Desktop Commander

by desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Runs in the cloud★ 211Updated 2 days ago

Install

Tool Guardian

by LuminariSoftwares

Too many MCP servers eating your context? A router that loads each tool's schema only when needed.

Runs on your computerUpdated today

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Ownly

Own less, Live more, Decide better.

中文文档

A local-first ownership memory and decision ledger.

Ownly helps you record what you own, what it costs, how you used it, and what you learned. Personal data stays in an Ownly data folder as plain Markdown with YAML frontmatter.

Ownly doesn't host your data. You choose where your files live.

The Ownly data folder can live in a normal local directory or inside a local folder synchronized by a personal cloud provider you control. Obsidian is useful for inspecting the Markdown, but it is not required for the hosted Web app, installed PWA, Agent CLI, or local MCP server.

Open Ownly

[Explore the product page](https://liuh886.github.io/ownly/)
[See the embedded product preview](https://liuh886.github.io/ownly/#preview)
[Open the Web app / PWA](https://liuh886.github.io/ownly/app/)

Entry point	Obsidian required?	Local process required?	Best for
GitHub Pages Web app	No	No	Immediate use in a supported desktop browser
Installed PWA	No	No	A standalone app window with offline application-shell startup
Obsidian plugin	Yes	No	Native Vault integration and direct Markdown work
Agent CLI	No	Yes	Deterministic scripting and validated local mutations
Local MCP	No	Yes	Bounded reads plus opt-in, preview-before-commit maintenance for compatible agents

The Web app and PWA are the same browser runtime. Installation changes the launch experience, not the data model. The product homepage itself is not a PWA surface.

First use: choose where your data lives

When Ownly starts without an existing folder permission, choose a storage location and then create new data or open an existing Ownly data folder.

On this device

Choose a normal local filesystem folder. Ownly reads and writes that folder directly. Nothing is synchronized unless you configure synchronization outside Ownly.

In your personal cloud folder

Choose a local folder already synchronized by Dropbox, Google Drive, OneDrive, iCloud Drive, or another provider you control.

Ownly still works with normal local files. It does not use provider APIs, OAuth, provider credentials, an Ownly cloud mirror, or a separate remote filesystem. Your provider handles synchronization under its own privacy and security policies.

Keep the folder available offline when the provider supports online-only placeholders, and use one sync provider per Ownly data folder to reduce conflicting copies.

Create new data

Select a parent location such as Documents, an Obsidian Vault root, a local personal-cloud folder, or an empty folder already named Ownly.

Ownly initializes:

Ownly/

Objects/ Accounts/ Snapshots/ Reviews/ Trips/ Trip Places/ Trip Visits/ Trip Legs/ Trip Expenses/ Logs/ Object Experiences/ Archive/ Objects/ Accounts/ Snapshots/ Reviews/ Object Logs/

If the selected folder is already named Ownly, Ownly uses it directly and does not create Ownly/Ownly.

Open existing data

Select any supported filesystem location:

an initialized Ownly data root containing Objects/;
an empty or initialized folder named Ownly;
an Obsidian Vault containing an Ownly/ child folder;
an Obsidian Vault using the plugin's configured Ownly data folder;
any of the above inside a local folder synchronized by the user's own provider.

The browser asks for explicit read/write permission. Personal Markdown files are not uploaded to GitHub Pages and are not copied into the PWA service-worker cache. If the selected folder is synchronized by a third-party provider, that provider may upload and synchronize those files independently of Ownly.

The hosted Web/PWA runtime uses Google Analytics 4 measurement ID G-KXXVS33FQ2 for product adoption and can also load Cloudflare Web Analytics for aggregate traffic and Web Vitals when NEXT_PUBLIC_CLOUDFLARE_WEB_ANALYTICS_TOKEN is configured at build time. Ownly custom analytics events never include Markdown contents, local file names, form values, object records, reviews, account snapshots, selected-folder data, local paths, inferred provider names, or MCP tool results. The Obsidian plugin, Agent CLI and MCP runtime do not load either web analytics provider.

Recommended storage

Standalone local use:

<My local folder>/

Ownly/ Objects/ Accounts/ Snapshots/ Reviews/ Trips/ Trip Places/ Trip Visits/ Trip Legs/ Trip Expenses/ Logs/ Archive/

Inside an Obsidian Vault:

<My Obsidian Vault>/

Ownly/ Objects/ Accounts/ Snapshots/ Reviews/ Trips/ Trip Places/ Trip Visits/ Trip Legs/ Trip Expenses/ Logs/ Archive/

Inside a personal cloud-synced local folder:

<My Dropbox / Google Drive / OneDrive / iCloud Drive folder>/

Ownly/ Objects/ Accounts/ Snapshots/ Reviews/ Trips/ Trip Places/ Trip Visits/ Trip Legs/ Trip Expenses/ Logs/ Archive/

All three layouts use the same Ownly data model. The personal-cloud option does not introduce a second storage backend; the external provider synchronizes the normal filesystem folder.

Product principles

User-controlled storage — Ownly does not host your personal ledger. You choose where the filesystem folder lives.
Local by default — no required cloud account, hosted database, provider OAuth, or mandatory synchronization.
Markdown native — records remain portable and human-readable.
Decision led — observe, acquire or pass, use, exit, and review.
Recoverable mutations — archive and restore are distinct from permanent deletion.
One data model — Web, PWA, Obsidian, CLI and MCP operate on the same schemas and directory structure.
Fact ready — scripts and external AI agents can consume deterministic data contracts; Ownly itself is not an AI assistant.

What Ownly tracks

Record	Purpose
Physical item	Purchase, use, cost, condition, retirement, transfer, or discard lifecycle
Recurring cost	Subscription or other repeating obligation, billing cycle, status, and annualized cost
One-time experience	Plan, budget, actual cost, location, completion, and review
Snapshot	Point-in-time net-worth and account-balance facts
Review	Structured post-use, post-exit, monthly, or annual reflection
Object experience log	Append-only usage, issue, maintenance, regret, lesson, comparison, or exit event

Fact-ready Agent CLI

Ownly exposes deterministic JSON read/write commands for scripts and external agents. It does not include model APIs, embeddings, AI chat, or generated recommendations.

export OWNLY_VAULT=/path/to/location-containing-Ownly

Recommended (wyqd remains for backward compatibility)

npm run --silent ownly -- object list --json

Legacy alias

npm run --silent wyqd -- object list --json npm run --silent wyqd -- object get --id --json npm run --silent wyqd -- object history --id --json npm run --silent wyqd -- object review-needed --json npm run --silent wyqd -- recurring list --active --json npm run --silent wyqd -- summary --json

See:

Agent CLI Contract
Agent CLI Guide
Data Model

The CLI data location may point to an Obsidian Vault or another filesystem location containing the Ownly data folder, including a user-controlled synchronized local folder.

Agent / MCP

Ownly also exposes a local-first MCP server for Codex, Claude Code and other MCP clients that can start a local STDIO process. It is read-only by default; persistent mutations require explicit startup permission plus a separate preview and commit call.

The MCP server is an adapter over the same validated Ownly data model. It does not create a second database, hosted mirror or embedded AI assistant.

The MCP tool surface covers:

data summary and Doctor health checks;
object search and bounded object facts;
object history with reviews and append-only experience logs;
active recurring costs;
upcoming subscription renewals;
recurring costs grouped by payment account with currencies kept separate;
deterministic review-needed records.
Planner trips, visits, budget estimates, and calendar projections, plus two-phase schedule edits and local OpenRouteService travel refresh/optimization.
opt-in creation and updates, lifecycle changes, append-only logs, reviews, snapshots, and recoverable archive/restore;
short-lived before/after previews, pre-write backups, stale-write conflict detection, and idempotent commits.

The source-of-truth stays in the user-selected Ownly data folder. Facts returned by an MCP tool can enter the connected external agent's context, so Ownly does not claim that every selected fact remains on-device during an agent session.

Install it with npx -y @ownly-app/mcp --data-dir (source in packages/mcp). See the Ownly MCP Guide for Codex and Claude Code setup, privacy boundaries and example prompts.

Current runtime status

Area	Status
Product homepage	Static bilingual product explanation with an embedded interactive preview
Hosted Web app	Static GitHub Pages runtime with user-selected filesystem access
Installed PWA	App-route-only install surface, standalone launch and cached app shell
Obsidian plugin	Native Vault interface over the shared Ownly data model
Agent CLI	Stable, strict-typed fact-ready JSON contract
Local MCP	Read-only by default; opt-in two-phase writes over the canonical Ownly evidence store
Data storage	Plain Markdown + YAML frontmatter in a user-controlled filesystem folder
Mutation safety	Validation, preview/commit confirmation, atomic writes, safety backups, audit logs, conflict detection, archive/restore, and CI contracts

Current validation and known coverage gaps are documented in Quality Baseline.

Browser support

Direct folder access uses the File System Access API.

Recommended: current desktop Chrome or Microsoft Edge.
Unsupported browsers can view the product page and embedded preview but cannot connect a real Ownly data folder.
Mobile direct-folder access is not a production target.
Browser permission may need to be renewed after restart or permission reset.
A personal cloud folder must be exposed by its provider as a usable local filesystem folder; Ownly does not provide a remote-drive API fallback.

See Web Runtime for privacy boundaries, PWA behavior, and deployment details.

Obsidian plugin

Install from Obsidian Community Plugins:

👉 [Install Ownly](https://obsidian.md/plugins?id=ownly)

The plugin is optional for Web/PWA users. Use the term Obsidian Vault only for a real Vault or the Obsidian runtime; the cross-runtime storage term is Ownly data folder.

Data health

Ownly includes deterministic Doctor checks for issues such as:

duplicate IDs;
unsupported schema versions;
invalid costs or dates;
missing object/review references;
stale snapshots;
missing data directories.

The

Only the beginning is shown; read the rest in the repo

Ownly

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Otheri

Common questions

Alternatives

Spec Driven Development

Remote Desktop Commander

Tool Guardian

README from the maker

Ownly

Open Ownly

First use: choose where your data lives

On this device

In your personal cloud folder

Create new data

Open existing data

Recommended storage

Product principles

What Ownly tracks

Fact-ready Agent CLI

Recommended (wyqd remains for backward compatibility)

Legacy alias

Agent / MCP

Current runtime status

Browser support

Obsidian plugin

Data health