はじめに

このプロジェクトは個人的な問題を解決するために作りました。Roam ResearchのグラフをClaude Code(および他のLLM)から直接管理したいというものです。AIエージェントにノートへのアクセスを提供するモデルコンテキストプロトコル(MCP)サーバーを構築しているうちに、基盤となるツールが十分に強力で独立して対応できることに気づきました。

AIエージェントのバックエンドとして始まったものが、やがて機能を備えたスタンドアロンCLIへと進化しました。今では、LLMを必要とせずに、端末から直接コンテンツの送受信、グラフ検索、タスク管理など、同じ強力なAPI機能を直接利用できます。

Claudeに知識ベースを特別な権限を与えたい場合でも、自分のスクリプトの堅牢なCLIを望む場合でも、このプロジェクトはあなたをサポートします。

v5.0の新要素

1行で: roam save は親ブロックの各名前の方法に対して1つのフラグを持ち、どちらも推測しません。--parent-uid は常にUID;--parent は常にテキストです。

4.1.0まで、--parentはブロックUIDか見出しテキストを使い、値の数字を探してどちらかを判断していました。RoamのUIDの約5件に1回は数字がないため、それらのセーブは静かに誤ルーティングされていました。4.1.

Roam Research MCP + CLI

Introduction

I created this project to solve a personal problem: I wanted to manage my Roam Research graph directly from Claude Code (and other LLMs). As I built the Model Context Protocol (MCP) server to give AI agents access to my notes, I realized the underlying tools were powerful enough to stand on their own.

What started as an backend for AI agents evolved into a full-featured Standalone CLI. Now, you can use the same powerful API capabilities directly from your terminal—piping content into Roam, searching your graph, and managing tasks—without needing an LLM at all.

Whether you want to give Claude superpowers over your knowledge base or just want a robust CLI for your own scripts, this project has you covered.

What’s New in v5.0

In one line: roam save now has one flag for each way of naming a parent block, and neither one guesses. --parent-uid is always a UID; --parent is always text.

Until 4.1.0, --parent took either a block UID or heading text and decided which by looking for a digit in the value. About one Roam UID in five has no digit, so those saves were silently misrouted. 4.1.0 added --parent-uid and deprecated passing a UID to --parent. 5.0 finishes the split.

• --parent-uid nests under the block with that UID. It accepts uid or ((uid)), and if no such block exists the command exits non-zero and writes nothing.
• --parent "" nests under the block with that text on the target page, creating it if missing. It is never read as a UID. --parent "((uid))" finds or creates a block whose content is that reference, which was not reliably possible before.