gitwtfhub

wtf is geode?

8thpark/geode — explained in plain English

Analysis updated 2026-05-18

25TypeScriptAudience · vibe coderComplexity · 2/5LicenseSetup · moderate

TL;DR

Geode is a free Obsidian plugin for encrypted remote note sync across devices, plus an MCP server and API so AI agents can read and write your vault.

Mindmap

mindmap
  root((repo))
    What it does
      Syncs Obsidian vault
      Encrypts before upload
      Multi device including iOS
    Tech stack
      TypeScript
      Obsidian plugin API
      MCP server
    Use cases
      Sync notes across devices
      Let AI agents read and write notes
      Use vault as agent memory
    Audience
      Obsidian users
      Developers building agents
    Security
      CodeQL scanning
      Dependabot audits
      OpenSSF Scorecard
    Status
      Early pre v0.1.0
      Actively accepting contributions

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Keep your Obsidian vault synced across a laptop, desktop, and iPhone using storage you control.

REASON 2

Let an AI agent like Claude or Codex read and write notes in your vault as a form of memory.

REASON 3

Access your Obsidian notes through an API from another app or automation.

REASON 4

Store notes with end to end encryption before they leave your device.

What's in the stack?

TypeScriptObsidianMCP

How it stacks up

8thpark/geodecodeweb-dev/spark-uicuzteam/cpapro
Stars252525
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasy
Complexity2/52/5
Audiencevibe coderdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Project is pre-v0.1.0 and still under active development.

You can use, modify, and share it freely, but if you distribute a modified version you must also release it under the same GPL-3.0 license.

Wtf does this do

Geode is a free plugin for Obsidian, the popular note taking app, that adds remote syncing of your notes across multiple devices, including iOS. Your notes are encrypted before they ever leave your device, and they are stored in storage that you own rather than a service controlled by the plugin's creators. The stated goal of the project is to make syncing feel invisible and reliable, comparing the bar they are aiming for to how effortlessly Apple Notes syncs without you ever having to think about it. Beyond syncing, Geode also runs a remote MCP server and an API for your vault. MCP, or Model Context Protocol, is a way for AI agents such as Claude or Codex to read and write files. With Geode's server enabled, an AI agent can read from and write to your Obsidian vault directly, effectively using your notes as a form of memory it can draw on and update. The project's authors describe this agent access as central to their vision, believing that connecting Obsidian to agents unlocks more of what the app can do. The project is still early. As of this README, the team is working toward its first v0.1.0 release and tracks progress through GitHub milestones. Contributions are welcomed, with issues labeled "Good First Issue" pointed out for newcomers, and a CONTRIBUTING.md file with more detail. Security is treated as a priority: every code change is scanned with GitHub's CodeQL, dependencies are checked by Dependabot and NPM Audit, and the project publishes an OpenSSF Scorecard that updates with each change. Anyone who believes they have found a security vulnerability is directed to a SECURITY.md file for how to report it. Geode is released under the GNU General Public License version 3.0, which means anyone can use, modify, and redistribute it, but any distributed derivative work must also be released under the same GPL-3.0 license.

Yoink these prompts

Prompt 1
Explain how Geode's MCP server lets an AI agent read and write my Obsidian notes.
Prompt 2
Help me set up Geode to sync my Obsidian vault to my own storage.
Prompt 3
Show me how to connect Claude to my Obsidian vault using Geode's MCP server.
Prompt 4
What does it mean that Geode encrypts my notes before they leave my device?

Frequently asked questions

wtf is geode?

Geode is a free Obsidian plugin for encrypted remote note sync across devices, plus an MCP server and API so AI agents can read and write your vault.

What language is geode written in?

Mainly TypeScript. The stack also includes TypeScript, Obsidian, MCP.

What license does geode use?

You can use, modify, and share it freely, but if you distribute a modified version you must also release it under the same GPL-3.0 license.

How hard is geode to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is geode for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.