roam-code

MCP server · GitHub · ★ 518 · graded 2026-10-19Source linked

Local codebase intelligence CLI + MCP server for AI coding agents: SQLite code graph, 28 languages, 287 commands, 246 MCP tools, change-safety gates, audit evidence, zero API keys.

No outside reports on file

roam-code reads local files; restrict its folder reach, network access, and credentials before installing.

Based on public adoption and transparency signals as of Oct 19, 2026. Our opinion, not a code audit or security guarantee.

Was this verdict for Roam Code helpful?

What it can access

Local filesReads & writes local foldersREVIEW
Command executionRuns shell or system commandsREVIEW
Network reachConnects to outside service APINOTED
CredentialsNo API token requiredLOW
Package sourceGitHub (Cranot/roam-code)PUBLIC

Inferred from this listing’s public package details and description. Check the project’s source before installing.

Install

No npm or PyPI package is listed. Install from source: github.com/Cranot/roam-code ↗

All setup options ↓

Check this skill Watch it in my stack Compare Add to allowlist README badge View project

About Roam Code

Roam Code is an MCP server focused on Developer tools and Data & databases: Local codebase intelligence CLI + MCP server for AI coding agents: SQLite code graph, 28 languages, 287 commands, 246 MCP tools, change-safety gates, review evidence, zero API keys.

It is hosted on GitHub at Cranot/roam-code (518 GitHub stars). Based on its public metadata, its operational scope includes: reads local files.

Setup

Check these steps against the project’s own instructions before running anything.

No standalone npm or PyPI package is listed for this MCP server. Clone and inspect the source repository directly:

bash

git clone https://github.com/Cranot/roam-code.git

Review the README and source files in https://github.com/Cranot/roam-code (opens external site) before running any setup commands.

Why this grade

CC — Moderate risk signals

Signal-based grade (3/7 points): well starred on GitHub, public source code. This reflects adoption and transparency, not a code review.

Popularity and upkeep

30/100

GitHub stars: 518
Listing last refreshed: 2026-10-29

These are public popularity signals, not a maintenance check. Look at the repository’s commit history and open issues.

Security reports

No reports found for this package in our research (last checked 2026-10-29).

Check a specific version →

Risks to watch for

Local file read access: Reads local documents or database files. Point it only at the specific files needed for the task so sensitive workspace files remain out of reach.
Dependency & version pinning: Distributed via GitHub (Cranot/roam-code). Pin an exact release version or commit SHA rather than floating tags so upstream updates are reviewed first.

How to lower the risk

Least-privilege permissions

Give it access only to the specific folders, accounts or projects it needs, never your whole drive or admin account.
Use a separate, limited API key or login just for this tool so you can switch it off without affecting anything else.

Network isolation

Run it on a work computer or sandbox account, not one holding personal or company-sensitive data.
If your IT team can, limit which websites and services it is allowed to contact.

Monitoring

Check its activity history or logs weekly at first, and look at what it changed or sent.
Turn on alerts for new logins or unusual usage on any account it connects to.

Red flags to watch for

It asks for more access than its job requires, or prompts you to paste passwords.
It suddenly updates with new owners, or starts contacting unfamiliar websites.

Questions

How do I install Roam Code?

Roam Code does not publish a standalone npm or PyPI package. Clone or follow the setup instructions in its source repository at github.com/Cranot/roam-code.

Are there security reports about Roam Code?

No reports found for this package in our research (last checked 2026-10-29). Roam Code currently holds Grade C (Moderate risk signals) based on public adoption and transparency signals. Key risk areas to watch include local file read access:, dependency & version pinning:.

Is Roam Code actively maintained?

Roam Code has 518 GitHub stars. Our directory data was last refreshed on 2026-10-29. Check recent commit activity, release tags, and open issues at github.com/Cranot/roam-code before pinning it in production.

What are alternatives to Roam Code?

You can compare Roam Code side by side with other SQLite MCP servers in the Related tools section on this page, or use the Compare tool on AgentArmorHQ.

Maintain or use Roam Code? Show its live grade in your GitHub README, docs site, or run a check from the terminal before you install.

GitHub README Markdown:

markdown

[![AgentArmorHQ Risk Grade for Roam Code](https://agentarmorhq.com/api/badge/cranot-roam-code)](https://agentarmorhq.com/skills/cranot-roam-code)

HTML embed:

html

<a href="https://agentarmorhq.com/skills/cranot-roam-code"><img src="https://agentarmorhq.com/api/badge/cranot-roam-code" alt="AgentArmorHQ Risk Grade for Roam Code" height="20" /></a>

Terminal check:

terminal

curl -fsSL https://agentarmorhq.com/api/cli | node --input-type=module - check "cranot-roam-code"

Share with your security lead

Need sign-off to use roam-code? Copy this note for Slack, a ticket or a pull request.

### AgentArmorHQ Security Review Memo: roam-code
- **Listing URL:** https://agentarmorhq.com/skills/cranot-roam-code
- **Type:** App connector
- **Risk Grade:** Grade C (Moderate risk signals)
- **Outside Security Advisories on File:** 0
- **Public Adoption:** 518 GitHub stars

#### Permission & Blast-Radius Signals
- **Local files:** Reads & writes local folders
- **Command execution:** Runs shell or system commands
- **Network reach:** Connects to outside service API
- **Credentials:** No API token required
- **Package source:** GitHub (Cranot/roam-code)

#### Recommended Hardened Setup
- **Source Repo:** https://github.com/Cranot/roam-code
- **Controls:** Pin an exact version in `.mcp.json`, scope access to a single workspace folder, and use a least-privilege read-only token where supported.

_Based on public adoption and transparency signals as of Oct 19, 2026. Our opinion, not a code audit or security guarantee._

Key facts

Type: App connector
Publisher: Cranot
Source code: github.com/Cranot/roam-code
Est. context load: ~700 tokens / turn (~4 tool schemas, 0.35% of 200k context)
Popularity: 518 GitHub stars
Last updated: 2026-10-29
Last graded: 2026-10-19

Community

Discussions for Roam Code

Ask questions or share configuration tips. Governed by our Community Rules & Terms.

No posts match this filter yet.

Be the first to ask a question or share a working tip.

Was this listing for Roam Code helpful?

Check before you install, in Claude

Your assistant answers Block, Review or No known issues for any package before it installs it.

Get this check inside Claude