Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Typed Graph

Volodymyr PavlyshynVolodymyr Pavlyshyn1k downloads

Typed, signed, labeled property graph over your notes with openCypher queries, edge properties and graph views.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates36

Typed Graph logo

Typed Graph

Your Obsidian notes as a real graph: typed, signed, labeled edges with properties, openCypher queries, a graph view that shows what it means, and RAG-ready storage for agents.

Live demo · Docs · Website · Download

Typed Graph rendering a typed, signed graph

Why

Obsidian links say that two notes are related, not how. Typed Graph lets one line say how:

---
type: Person
---
knows:: [[Bob]] {since: 2020, label: "met at NeurIPS"}
works_at:: [[Acme]]
-distrusts:: [[Mallory]]

Then you can ask the vault questions in openCypher, inside any note:

```graph-query
MATCH (p:Person)-[c:contributes]->(proj:Project)
RETURN p.title AS person, proj.title AS project, c.hours AS hours
ORDER BY hours DESC
```

Features

  • Typed, signed edges with properties. type:: [[Target]] {props} works like Graph Link Types, so your existing lines keep working. A - prefix makes an edge negative, and edges can have stable or pinned ids.
  • Typed nodes and schema notes. Frontmatter type gives a note its labels. A note in Types/ declares a type's properties, allowed edges, template and look.
  • openCypher queries. MATCH, OPTIONAL MATCH, WITH, aggregates, variable-length paths and path variables. Queries are read-only and errors are clear.
  • Note variables and built-in metadata. A block can use the note it sits in: {{path}}, {{title}}, {{folder}} and frontmatter as {{fm.status}} become Cypher literals, so MATCH (me {path: {{path}}})-[r]-(x) RETURN me, r, x works in any note. Every node has path, title, stub and its frontmatter, and every edge has r.sign, r.id and its {props}, with no schema. The Graph view binds $activeFile. See the query cheat sheet.
  • Graph or table, live. Results render as a labeled, styled graph or a table, and refresh as you edit.
  • Graph view. A full-pane explorer that follows the active note, expands neighbors and explains where each style comes from. Frontmatter subtitle: billing draws specs/billing/spec.md as spec — billing, so notes that share a file name stay apart. It is a separate view. Obsidian's core Graph view is left unchanged, but you can color types there yourself with groups such as [type:Person] (see the docs).
  • AsciiDoc notes. .adoc files are typed notes too: properties in a leading //// block or :tg-*: attributes, edges in // @tg: cites:: [[Source]] comments, so Asciidoctor renders the file exactly as before. See the docs.
  • Edge embeds. {{edge: Alice -knows-> Bob . since}} shows an edge's property inside your prose.
  • Optional sidecar. A LadybugDB mirror for full Cypher, local vector search (Ollama), GraphRAG with citations, and an MCP server for agents.
Table result Variable-length paths
Per-block styling Dark theme

The screenshots come from the live demo, which runs the plugin's own query engine, schema styling and renderer in your browser.

Install

  • Community plugins (recommended): open Typed Graph in Obsidian, or go to Settings → Community plugins → Browse, search for Typed Graph, then install and enable it. Directory page: community.obsidian.md/plugins/typed-graph.
  • BRAT, for beta builds: install Obsidian42 - BRAT, run Add a beta plugin, and enter Volland/typedgraph.
  • Manually: download main.js, manifest.json and styles.css from the latest release into <vault>/.obsidian/plugins/typed-graph/, reload Obsidian, and enable the plugin.

The plugin works on desktop and mobile, and it never modifies your notes.

Quick start

  1. Add type: Person to a note's frontmatter.
  2. Write an edge line such as knows:: [[Bob]] {since: 2020}.
  3. Add a graph-query block with MATCH (a:Person)-[r:knows]->(b) RETURN a, r, b.
  4. Run Typed Graph: Open graph view to explore.

Try the demo vault: download typed-graph-demo-vault.zip, unzip it and open the folder as a vault. The plugin is preinstalled. Open Start Here for a tour and a hands-on Cypher manual. From a clone, npm run example:install builds the plugin into example/ instead.

The full guide covers edge syntax, schema notes, styling precedence, the Cypher subset, embeds and settings: typedgraph.org/docs.html. For the variables and properties a query can use without declaring anything, keep the query cheat sheet open.

CLI: tg

@typedgraph/cli is a standalone command line, a drop-in replacement for lat.md that also links code into the typed graph. It reads the same lat.md/ folder and gives the same check verdicts (a test compares it with lat check on real projects).

npx @typedgraph/cli init            # set up: pick agents, parts and docs folder in a terminal, then it writes
npx @typedgraph/cli init --dry-run  # only print the diff of what it would change
tg check                            # links, code refs, annotations, index files, section structure
tg search "how are edges signed"    # lexical by default; hybrid with TG_EMBED_PROVIDER or a key
tg section "edge-syntax#Sign"
tg cypher "MATCH (s:Section)-[:references]->(t:Section) RETURN s.title, t.title LIMIT 5"
tg export ./out --vault ~/vault     # vault notes to a lat.md folder (lossy, with a report)
tg import ../project/lat.md         # adopt a lat.md folder (--mount to symlink)

Code points at docs with // @lat: [[section]] (a plain link) or a typed edge, // @tg: implements:: [[auth#Login]] {since: 2}. tg mcp serves the same commands to agents over MCP. In Obsidian, Code in the graph (settings or the Graph view dropdown) shows annotated symbols as nodes without writing anything to the vault. Design: lat.md/cli.md.

For agents: the sidecar

packages/sidecar is a headless service over a read-only copy of your vault. It needs no Obsidian. It offers REST, an MCP server, a LadybugDB mirror, local vector search and GraphRAG.

npm install && npm run build:sidecar
claude mcp add typed-graph \
  -e OBSIGRAPH_VAULT=/path/to/vault -e OBSIGRAPH_DATA=/path/to/data \
  -- node packages/sidecar/dist/server.mjs --stdio

The MCP tools are cypher_query, vector_search and graphrag_retrieve, all read-only. For REST endpoints, Docker and environment variables, see the sidecar docs.

Development

packages/core     edge parser, graph model, schemas, styles, openCypher engine, embeddings (no Obsidian APIs)
packages/plugin   the Obsidian plugin
packages/sidecar  headless REST + MCP service, LadybugDB mirror, vector index, conformance suite
site/             the website and live demo (GitHub Pages)
lat.md/           architecture and test specs (lat.md)
openspec/         specs and archived changes (OpenSpec)
npm install
npm run verify                      # typecheck + tests + lat check
OBSIGRAPH_OUT="<vault>/.obsidian/plugins/typed-graph" npm run build   # build the plugin into a vault
npm run site:build && npx serve site                                 # preview the website

Releasing

  1. Run npm run version:bump -- 0.5.0. This updates manifest.json, versions.json and every package version.
  2. Commit, then run git tag 0.5.0 && git push origin 0.5.0. The tag has no v prefix.
  3. The Release plugin workflow typechecks, tests, builds, and attaches main.js, manifest.json and styles.css to the GitHub release.

Submitting to the Obsidian community directory

Obsidian takes submissions through its web directory, not through pull requests. community-plugins.json in obsidianmd/obsidian-releases is only a mirror of it.

  1. Sign in at community.obsidian.md with your Obsidian account, and link your GitHub account to prove you own the repo.
  2. Add the plugin from the Volland/typedgraph repository. The directory reads README.md, LICENSE and the root manifest.json, and installs from the GitHub release tagged with the manifest version.
  3. An automated review runs. To fix anything it reports, update the repo and publish a new release with a higher version (npm run version:bump, then push the tag).

License

MIT © Volodymyr Pavlyshyn. Not affiliated with Obsidian or LadybugDB.

HealthExcellent
ReviewCaution
About
Model your Obsidian notes as a typed graph with signed, labeled edges, node and edge properties, and stable or pinned IDs. Query the vault with openCypher and render live results as a styled graph or table, embed edge properties in prose, and use RAG-ready storage for agents. Explore a full-pane graph view that follows the active note and explains styles and connections.
VisualizationDataProperties
Details
Current version
0.28.0
Last updated
Last week
Created
2 months ago
Updates
36 releases
Downloads
1k
Compatible with
Obsidian 1.8.7+
Platforms
Desktop, Mobile
License
MIT
Report bugRequest featureReport plugin
Sponsor
PayPal
Author
Volodymyr PavlyshynVolodymyr Pavlyshynpavlyshyn
www.pavlyshyn.me
GitHubvolland
pavlyshyn
volodymyrpavlyshyn.substack.com
VolodymyrPavlyshyn
medium.com
  1. Community
  2. Plugins
  3. Visualization
  4. Typed Graph

Related plugins

Advanced Canvas

Supercharge your canvas experience. Create presentations, flowcharts and more.

Heatmap Tracker

Visualize your activity and track goals, progress, habits, tasks, exercise, finances, and more—all in a single, interactive heatmap!

Excalidraw

Visual PKM powerhouse. Create and edit Excalidraw drawings.

ExcaliBrain

An interactive, structured mind-map of your Obsidian vault.

Breadcrumbs

Visualise the hierarchy of your vault using a breadcrumb trail or matrix view.

Meta Bind

Make your notes interactive with inline input fields, metadata displays, and buttons.

Mermaid Tools

Improved Mermaid.js experience: visual toolbar with common elements and more.

Maps

Adds a map layout to bases so you can display notes as an interactive map view.

Force note view mode

Force the view mode for a note by using frontmatter: YAML block with 'obsidian_ui_mode' as key.

Update modified date

Automatically update a frontmatter modified date field when the file is modified.