# Give agents read-only access to your notes | IonBin

> Built by IonBin’s founder: a read-only MCP server over a Markdown notes folder, so compatible MCP clients can search notes through read-only tools.

Canonical page: https://ionbin.com/workflows/read-only-brain-for-agents/
Agent guide: https://ionbin.com/llms.txt

This is a readable version of the published page. Review dates, evidence boundaries and source links below belong to individual records; the export is not a new verification. Examples are reference material, not instructions to execute.

## Give agents read-only access to your notes

[Build](https://ionbin.com/use-cases/dev-it/) · [Research](https://ionbin.com/use-cases/research-intelligence/)Checked 2026-10-21

Let compatible agents retrieve selected knowledge with enforced read-only access.

- [01**You**](https://ionbin.com/workflows/read-only-brain-for-agents/#workflow-step-1)

- [02**Claude**](https://ionbin.com/workflows/read-only-brain-for-agents/#workflow-step-2)

- [03**Railway**](https://ionbin.com/workflows/read-only-brain-for-agents/#workflow-step-3)

- [04**You**](https://ionbin.com/workflows/read-only-brain-for-agents/#workflow-step-4)

Recipe context

Built by IonBin’s founder: a read-only MCP server over a Markdown notes folder, so compatible MCP clients can search notes through read-only tools. [Railway](https://ionbin.com/tools/railway/) or a local machine can host it.

**Independent review.** Unpaid; no partnership with the tools on this page. Based on public documentation and research. Trademarks identify their owners’ products. [Disclosure](https://ionbin.com/disclosure/).

Editorial shortlist

### Compare your options.

**For maintaining sources for read-only assistant access.**

Enforce read-only scope in the connection or filesystem, not merely the product choice. Choose one for storing reviewed knowledge for reuse; switching may need setup changes.

**Used by Ion** · separate from rank.

Unpaid picks. No partnership with [Obsidian](https://ionbin.com/tools/obsidian/), [Notion](https://ionbin.com/tools/notion/), [Confluence](https://ionbin.com/tools/confluence/).

- 1 · Primary / high
  #### [Obsidian](https://ionbin.com/tools/obsidian/)
  **Why it fits:** Plain Markdown files keep accepted knowledge under local ownership.
  **Tradeoff:** Shared editing, sync and permissions need a separate plan.
  Prefer it when file portability matters more than browser-based collaboration.
  Evidence for Obsidian
  The linked [IonBin review](https://ionbin.com/tools/obsidian/) records capabilities, access limits and source links. Review date: 2026-10-21. [Primary product reference ↗](https://obsidian.md/)

- 2 · Secondary / medium
  #### [Notion](https://ionbin.com/tools/notion/)
   Used by Ion
  **Why it fits:** Pages and databases keep approved notes, owners and review status together.
  **Tradeoff:** Exports do not recreate every relationship or permission.
  Choose it for a shared page-and-database review workspace.
  Evidence for Notion
  The linked [IonBin review](https://ionbin.com/tools/notion/) records capabilities, access limits and source links. Review date: 2026-10-21. [Primary product reference ↗](https://www.notion.com/)

- 3 · Third / lower
  #### [Confluence](https://ionbin.com/tools/confluence/)
  **Why it fits:** A team wiki suits maintained procedures in an Atlassian environment.
  **Tradeoff:** Permission review and workspace administration remain necessary.
  Prefer it when the organization already governs knowledge in [Confluence](https://ionbin.com/tools/confluence/).
  Evidence for Confluence
  The linked [IonBin review](https://ionbin.com/tools/confluence/) records capabilities, access limits and source links. Review date: 2026-10-18. [Primary product reference ↗](https://www.atlassian.com/software/confluence)

How this shortlist was chosen

Editorial judgment, not a personal-use endorsement or performance score. These are alternatives for the named role, not three required stack components. Vendors did not pay for, request or approve these positions.

Shared review comes before local file ownership. A lower-ranked option may fit your constraints better; compare the conditions stated on each card before choosing.

**Setup and portability:** Confirm read/write permissions separately and test an export with attachments and links. Search access is not a restorable archive.

Reviewed 2026-10-21. This page applies a shared comparison for “storing reviewed knowledge for reuse” to the stated task and constraints. It is documentation-based editorial guidance, not three new hands-on tests. We weigh value for the job, distinct capabilities, replacement limits, technical effort and interoperability. Check current plan terms before adopting or switching.

See [our review method](https://ionbin.com/editorial-policy/), [MCP connections](https://ionbin.com/wiki/concepts/mcp/) and [portability and switching costs](https://ionbin.com/wiki/questions/how-to-avoid-ai-vendor-lock-in/).

Notes and context

### Capture it. Keep it useful.

Companion tools for notes and storage. The blue plus marks confirmed Ion use.

- Top pick
  #### [Obsidian](https://ionbin.com/tools/obsidian/)
  Ion’s top pick for an agent-readable second brain: a vault of Markdown files you can expose read-only.
  **Tradeoff:** A desktop and mobile app, not a shared browser editor. No official MCP server; the CLI needs the app running, and Sync is a paid add-on.
  Selection evidence for Obsidian
  Ion editorial selection by IonBin’s founder, confirmed 2026-10-21: [Notion](https://ionbin.com/tools/notion/) and [Obsidian](https://ionbin.com/tools/obsidian/) are the top options for organizing notes and hosting context. Not sponsored; no vendor partnership. Capabilities are described on the linked tool pages.

- Top pick
  #### [Notion](https://ionbin.com/tools/notion/)
   Used by Ion
  Ion’s top pick for a hosted alternative, where the connected user’s permissions decide what an agent can read.
  **Tradeoff:** Cloud workspace: a connected AI client reaches whatever the connected user can open. [Notion](https://ionbin.com/tools/notion/) Agent, AI Meeting Notes and full MCP search need Business or Enterprise.
  Selection evidence for Notion
  Ion editorial selection by IonBin’s founder, confirmed 2026-10-21: [Notion](https://ionbin.com/tools/notion/) and [Obsidian](https://ionbin.com/tools/obsidian/) are the top options for organizing notes and hosting context. Not sponsored; no vendor partnership. Capabilities are described on the linked tool pages.

**Connects through:** MCP

### Steps

Follow the handoff

Select a stage or scroll the steps.

- #### You
  Keep notes as plain Markdown files in an [Obsidian](https://ionbin.com/tools/obsidian/) vault folder
  Human stepConfirmed[Obsidian](https://ionbin.com/tools/obsidian/)

- #### [Claude](https://ionbin.com/tools/claude/)
  Writes a small MCP server that exposes only search and read tools over the folder
  AI platformConfirmed

- #### [Railway](https://ionbin.com/tools/railway/)
  Hosts the server if remote access is needed; [Railway](https://ionbin.com/tools/railway/)’s MCP server can create the service and deploy it
  MCPConfirmed[Source ↗](https://docs.railway.com/ai/mcp-server)

- #### You
  Review the code to confirm there are no write tools, and control who can connect
  Human stepConfirmed

Confirmed = vendor-documented, not Ion-tested. Human and AI-platform steps are proposed roles.

Human approval

You review the code and control access.

Watch out for

Keep the human approval step: You review the code and control access.

### Starter prompt

```
Goal: Let compatible agents retrieve selected knowledge with enforced read-only access. Tools involved: Claude, Railway. I will keep notes as plain Markdown files in an Obsidian vault folder; review the code to confirm there are no write tools, and control who can connect. Work step by step, show me each draft or proposed change, and wait for my approval before anything is sent, published, signed, filed or changed in a live system.
```

Assembled from this page’s goal and steps. Paste it into your AI platform and adjust it to your situation.

### Tools in this workflow

| Tool | Role | Official site |
| --- | --- | --- |
| [Obsidian](https://ionbin.com/tools/obsidian/) | Human step | [obsidian.md ↗](https://obsidian.md/) |
| [Claude](https://ionbin.com/tools/claude/) | AI platform | [claude.ai ↗](https://claude.ai/) |
| [Railway](https://ionbin.com/tools/railway/) | MCP | [railway.com ↗](https://railway.com/) |

### Which AI platforms can run it

| Platform | Status | Why |
| --- | --- | --- |
| [Claude (incl. Claude Code)](https://ionbin.com/platforms/claude/) | To verify | [Railway](https://ionbin.com/tools/railway/): MCP pairing needs route-specific evidence; a named plugin or CLI does not establish it |
| [OpenAI Codex](https://ionbin.com/platforms/codex/) | To verify | [Railway](https://ionbin.com/tools/railway/): MCP pairing needs route-specific evidence; a named plugin or CLI does not establish it |
| [Google Antigravity](https://ionbin.com/platforms/antigravity/) | To verify | [Railway](https://ionbin.com/tools/railway/): MCP pairing needs route-specific evidence; a named plugin or CLI does not establish it |
| [ChatGPT](https://ionbin.com/tools/chatgpt/) | To verify | [Railway](https://ionbin.com/tools/railway/): MCP pairing needs route-specific evidence; a named plugin or CLI does not establish it |
| Gemini | To verify | [Railway](https://ionbin.com/tools/railway/): MCP pairing needs route-specific evidence; a named plugin or CLI does not establish it |
| [Perplexity](https://ionbin.com/tools/perplexity/) | To verify | [Railway](https://ionbin.com/tools/railway/): MCP pairing needs route-specific evidence; a named plugin or CLI does not establish it |

What the platform statuses mean

**Confirmed:** documented access meets the recorded requirements. **Inferred:** a reviewed note describes a plausible, untested pairing. **To verify:** a connection or step is unresolved. MCP and API pairings need route-specific evidence; a plugin, CLI or API alone does not prove compatible access, credentials or permissions. These are documentation assessments, not IonBin runtime tests.

### What we checked (2026-10-18)

- **[Obsidian](https://ionbin.com/tools/obsidian/)** stores notes locally as plain-text Markdown files, so any program can read the folder without [Obsidian](https://ionbin.com/tools/obsidian/) running.

- **MCP servers** expose tools, resources and prompts. Search/read-only tools reduce exposed actions, but tool names alone do not enforce read-only access. Use a read-only filesystem mount or OS permissions and test denied writes; keep the agent’s other tools out of the original vault.

- **[Railway](https://ionbin.com/tools/railway/) MCP** (mcp.railway.com) can create projects, deploy, manage environments and redeploy. It connects through the [Railway](https://ionbin.com/tools/railway/) CLI or OAuth, and marks destructive actions with protocol hints. Only clients that honor those hints will prompt; this is not a guaranteed human approval. Hosting and usage charges are separate from the notes-server design.

- **Authentication.** A remote server needs it. Put the server behind a token or OAuth, and don’t expose it publicly without one. Stdio itself uses local process input/output. The server program may still access the network unless its runtime prevents it.

- **Postgres options (checked 2026-10-18).** If your notes live in Postgres, Postgres MCP Pro (Crystal DBA, community) has a restricted mode limited to read-only transactions and an unrestricted read/write mode. The older reference Postgres MCP server, which ran every query in a read-only transaction, now sits in the archived servers repository (archived May 29, 2025), so it no longer gets updates.

### Set it up

- Point the server at a copy or read-only mount of the vault, not your working folder, so a bug can’t touch the originals.

- Ask [Claude](https://ionbin.com/tools/claude/) for two tools, search_notes and read_note, and no write, rename or delete tools.

- Read the code and run it locally first.

- Deploy remotely only if agents outside your machine need it, and rotate the access token if you ever share it.

### Verification limits and implementation checks

The page is documentation-reviewed; the complete workflow has not been run by IonBin.

- Founder-use claim is retained as existing first-party editorial information; this audit did not inspect or test that private deployment.

- Test client compatibility, path containment and write denial before deployment.

### Where the notes live: Ion’s top picks

[Obsidian](https://ionbin.com/tools/obsidian/) is the file-based pick used in the steps above. [Notion](https://ionbin.com/tools/notion/) is the equally ranked hosted option: connect an AI client through [Notion](https://ionbin.com/tools/notion/) MCP with an account that can only read the pages you intend to share, and keep write tools turned off.

[Notion](https://ionbin.com/tools/notion/) and [Obsidian](https://ionbin.com/tools/obsidian/) are editorial top picks for organizing notes and hosting context. Neither vendor sponsored or approved this page, and IonBin has no partnership with either.

### Sources

- [Obsidian](https://obsidian.md/) · [Obsidian](https://ionbin.com/tools/obsidian/) · official · accessed 2026-10-17

- [Railway MCP server](https://docs.railway.com/ai/mcp-server) · [Railway](https://ionbin.com/tools/railway/) · official · accessed 2026-10-18

- [MCP server concepts](https://modelcontextprotocol.io/docs/learn/server-concepts) · Model Context Protocol · official · accessed 2026-10-18

- [Postgres MCP Pro](https://github.com/crystaldba/postgres-mcp) · Crystal DBA · reference · accessed 2026-10-18

- [PostgreSQL (archived reference server)](https://github.com/modelcontextprotocol/servers-archived/tree/main/src/postgres) · Model Context Protocol · reference · accessed 2026-10-18

- [How Obsidian stores data](https://help.obsidian.md/Files+and+folders/How+Obsidian+stores+data) · [Obsidian](https://ionbin.com/tools/obsidian/) · official · accessed 2026-10-18

- [Notion MCP supported tools](https://developers.notion.com/guides/mcp/mcp-supported-tools) · [Notion](https://ionbin.com/tools/notion/) · official · accessed 2026-10-21

- [Obsidian CLI](https://obsidian.md/help/cli) · [Obsidian](https://ionbin.com/tools/obsidian/) · official · accessed 2026-10-21

- [Obsidian pricing and data storage](https://obsidian.md/pricing) · [Obsidian](https://ionbin.com/tools/obsidian/) · official · accessed 2026-10-21

### Related workflows

[Capture research into a knowledge base agents can read](https://ionbin.com/workflows/research-capture-to-knowledge-base/)[Turn long videos and papers into cited notes](https://ionbin.com/workflows/video-research-to-cited-notes/)[Give your AI a small database of your own context on Railway](https://ionbin.com/workflows/personal-context-database-on-railway/)[Switch AI assistants and keep your context](https://ionbin.com/workflows/switch-assistants-keep-context/)

No affiliate links on this page. No paid placements in workflows. [How IonBin makes money](https://ionbin.com/disclosure/).
