Obsidian Stats logoObsidian Stats

Open Ontologies

by fabio rovai
5
4
3
2
1
Score: 50/100
Install Code

Description

Full Open Ontologies engine in Obsidian: reason over, SHACL-check and SPARQL-query your vault as a knowledge graph, and expose it to Claude over MCP

Reviews

No reviews yet.

Stats

0
stars
downloads
0
forks
1
days
1
days
1
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
16
commits

Latest Version

0.1.4
a day ago

Changelog

Store-review pass: fixes every blocking finding from the community-store automated review, plus the lint warnings behind them.

Fixed

  • Declared minAppVersion was older than the APIs actually used. The manifest claimed 1.5.0 while the plugin calls workspace APIs introduced later, so Obsidian could have loaded it into a version that cannot run it.
  • Settings headings and styles now use the Obsidian APIs. Section headings are Setting.setHeading() rather than raw h3 elements, and the engine log pane is styled through a CSS class instead of assigning element.style directly, so it follows the user's theme.
  • All network calls go through requestUrl. fetch is subject to CORS in Obsidian's renderer; both the engine download and the MCP client now use Obsidian's exempt transport, injected so tests and any plain Node caller keep the fetch default.
  • Timers use window.setTimeout for popout-window compatibility, promises are no longer left floating, DOM is built with the createEl helpers, and the deprecated setWarning button API was replaced.

Added

  • Build provenance attestations on main.js, manifest.json and styles.css, so a user can cryptographically verify a release was built from this repository.
  • Release notes are now published with each release.
  • ESLint with the official Obsidian plugin ruleset, wired into CI, so store-review findings surface before submission rather than after.

Full Changelog: https://github.com/fabio-rovai/obsidian-open-ontologies/compare/0.1.3...0.1.4

See all version on GitHub

README file from

Github

The full Open Ontologies engine inside Obsidian. Every engine tool, reasoners included: validate, reason over, SHACL-check, diff, lint and SPARQL-query ontology files in your vault, and compile the vault itself (notes, frontmatter, tags, wikilinks) into an RDF graph you can reason over.

Desktop only. On first run the plugin downloads the pinned engine release for your platform, verifies it against the published SHA-256 checksums, starts it on a loopback-only port with a generated access token, and manages its lifecycle. Already have the engine installed? Point the plugin at your binary in settings.

Features

  • Ontology tree pane, SPARQL console with history, validation panel with per-note deep links
  • Validate-on-save for .ttl, .owl, .rdf and .jsonld files
  • Vault to RDF mapping: notes become individuals, type: frontmatter becomes rdf:type, property:: [[Target]] inline fields become object properties, tags become SKOS concepts
  • Inferred connections: see the links your notes entail but never stated
  • Every engine tool is reachable; reasoning profiles from RDFS to full OWL 2 DL tableaux

Give your AI agent a reasoned second brain

The engine this plugin runs is an MCP server, so Claude Code and Claude Desktop can query your vault as a knowledge graph.

That is a different thing from letting an agent read your files. Tools like mcp-obsidian already do file read, write and search well, and this plugin does not duplicate them; the two compose, and you can connect both. What this adds is reasoning. Your agent can ask which notes violate a shape, what is transitively part of a project, or which people sit two hops from a topic, and get answers derived from the graph rather than inferred from text.

Open the plugin settings, click Copy MCP client config, and paste the result into your Claude Code config (.mcp.json or ~/.claude.json) or Claude Desktop's claude_desktop_config.json:

{
  "mcpServers": {
    "open-ontologies": {
      "type": "http",
      "url": "http://127.0.0.1:27125/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

The equivalent CLI form is:

claude mcp add --transport http --header "Authorization: Bearer YOUR_TOKEN" \
  open-ontologies http://127.0.0.1:27125/mcp

The endpoint listens on loopback only and always requires the token. Treat that token like a password: anything holding it can read and modify your vault graph. You can regenerate it from settings at any time, which immediately invalidates any config you copied earlier.

Auto-sync is on by default, so the graph your agent queries is recompiled ten seconds after your last note change.

One honest caveat about how much this buys you

Reasoning needs types. A vault of untyped notes and plain wikilinks compiles to a flat graph of "links to" statements, and a reasoner derives nothing interesting from it. The payoff scales with how much structure your vault actually carries.

Run the Install starter vault ontology command to get a working vocabulary (Note, Person, Project, Task, Source, Idea, Topic) with partOf declared transitive and relatesTo declared symmetric, plus SHACL shapes. Then add frontmatter like type: "[[Project]]" to the notes you care about, and use property:: [[Target]] for relations that mean something. Once that is in place, marking a task as part of a project that is part of a programme lets the reasoner conclude the task belongs to the programme, without you ever writing that down.

Install

Until the community-store listing lands, install with BRAT using this repo, or copy main.js, manifest.json and styles.css from the latest release into .obsidian/plugins/open-ontologies/.

Sibling channels

The same engine ships as a Rust binary and MCP server, a Docker image and a PyPI package.

Development

npm install
npm run build        # bundle to main.js
npm test             # unit tests
npx tsc --noEmit     # typecheck

# End-to-end against a real engine binary
OO_E2E=1 OO_ENGINE_BIN=/path/to/open-ontologies npm test
Sponsors