SystemSculpt
Install free (opens Obsidian's plugin directory in a new tab)

How to Chat with Your Obsidian Notes Using AI

Published Updated 5 min read

SystemSculpt chat's message box with a meeting note and a printer quote PDF attached to a question about the launch walk.SystemSculpt chat's message box with a meeting note and a printer quote PDF attached to a question about the launch walk.
A note and a PDF, attached to one question.The Beach at Sainte-Adresse, Claude Monet, 1867
On this page

To chat with your Obsidian notes using AI, install a plugin that can read your vault, open its chat and attach the notes you want it to use. With SystemSculpt, free to install, type @ to attach a note and ask your question; chat runs on your own Claude Code or Codex on desktop, or on SystemSculpt's hosted AI on desktop and mobile.

Use SystemSculpt if you want one chat that can read and edit notes in your vault, saves each conversation there as a Markdown note, and works with related notes, transcripts and PDFs. If you only want quick actions on selected text with a local model, Local GPT is lighter; our comparison of Obsidian AI plugins covers the options.

What you need

  • Obsidian 1.7.2 or later, on desktop or mobile.
  • SystemSculpt AI from Obsidian's community plugins. It's free to install.
  • One AI to answer: your own Claude Code or Codex, installed and signed in on the same desktop computer, with no SystemSculpt plan needed; or hosted SystemSculpt AI, which uses a free SystemSculpt account and credits. Eligible new accounts can claim 500 one-time starter credits with no card.

Start a chat about a note

  1. In Obsidian, open Settings → Community plugins, find SystemSculpt AI, then select Install and Enable.
  2. Select Open chat in the left ribbon, or run Open chat from the command palette.
  3. Check the line below the message box. It shows who answers (Claude Code, Codex or SystemSculpt) and the mode. Change either one there. To use hosted AI, choose SystemSculpt and sign in when asked.
  4. Type @ or [[ and choose a note, or use + → Add current note.
  5. Ask something you can check against the note, such as: "Summarize the decisions in this note and list the open questions."

Your chat is saved as a Markdown note in your vault. Press Cmd/Ctrl+K in the chat to search past chats and pick one up again.

Ask across several notes

Attach more than one note with @, or use + → Add notes from vault… to pick several at once. To keep a note with every message in the chat, use + → Pin files for every message…. You can also ask the AI to find the relevant notes itself; the chat shows which files it reads.

Ask for something that needs evidence, such as: "List the decisions, unfinished actions and open questions from these notes, and name the source note for each." Then open the source notes to confirm.

Sometimes you don't know which notes to attach. SystemSculpt's Similar Notes panel lists notes related to the one you have open, and Open search finds notes by meaning as well as by exact words. Turn on Similar notes under Settings → SystemSculpt AI → Knowledge to build the index. Indexing runs on SystemSculpt's hosted service and uses credits, even if you chat with your own Claude Code or Codex. The semantic search guide has the details.

Bring in audio and PDFs

A recording or a PDF becomes easier to chat about once it is a note:

  • Audio: record with Toggle audio recorder, or run Open audio processor to turn a recording or a YouTube video into a note with a summary and a timestamped transcript. See how to transcribe audio in Obsidian.
  • PDFs and images: open a PDF, PNG, JPG or WebP file's menu and choose Convert to Markdown, then attach the new note. Check names, numbers and tables against the original.
  • Chat with file: choose Chat with file from a file's menu to start a chat about it.

Transcription and document conversion run on SystemSculpt's hosted service and use credits.

When the chat changes a note

The AI in SystemSculpt chat can create and edit notes, not only answer. How often it asks first depends on the mode shown in the run line. New chats start in Auto: hosted SystemSculpt AI creates and edits notes without asking and asks before moving or deleting them. Choose Ask to approve every change. Claude Code and Codex use their own modes, such as Claude Code's Ask before edits.

When an approval is needed, the request appears in the conversation with the proposed change. Press Enter to approve or Escape to deny. Read how the agent's approval modes work before you let it work on notes that matter.

Where your notes and chats go

Your notes stay files in your vault, and chats and written results are saved there as Markdown. To answer, the AI needs to see what you attach: hosted SystemSculpt AI sends that content to SystemSculpt's service, and your own Claude Code or Codex sends it to its own AI service, as it would in a terminal. Neither is offline AI. Attach only what the question needs, and see the Privacy Policy for how hosted content is handled.

Questions

Can ChatGPT or Claude read my Obsidian notes? Not from the ChatGPT or Claude websites on their own. A plugin brings an AI into Obsidian: SystemSculpt runs your installed Claude Code or Codex inside your vault on desktop, where it can read the notes you attach or ask it to find.

Does Obsidian have built-in AI? No. The Obsidian app has no AI chat of its own; an AI assistant comes from a community plugin such as SystemSculpt, Copilot or Smart Connections.

Is there an AI agent for Obsidian? Yes. SystemSculpt, Copilot, Claudian and Agent Client run Claude Code or Codex inside your vault on desktop, where the agent can find, read and edit notes. SystemSculpt can ask for your approval before each edit.

Can I chat with my notes using a local model? Not with SystemSculpt, which runs Claude Code, Codex or hosted SystemSculpt AI. Plugins such as Copilot, Local GPT and Smart Composer can use local models.

Does it work on my phone? Yes. In Obsidian on iPhone, iPad and Android, SystemSculpt chat uses hosted SystemSculpt AI. Claude Code and Codex run on desktop only.

Is it free? SystemSculpt is free to install, and chat with your own Claude Code or Codex needs no SystemSculpt plan. For hosted AI, eligible new accounts can claim 500 one-time starter credits; after that, Monthly is $9 a month and Yearly is $90 a year, each with a monthly credit allowance. See pricing.

Install SystemSculpt from the Obsidian directory, follow getting started, or read the chat workspace guide. See everything SystemSculpt does.

TopicsObsidianObsidian AIAI AssistantKnowledge ManagementSystemSculpt

Try SystemSculpt inside your vault

AI chat, search and transcription in Obsidian, saved as Markdown in your vault.

Useful ideas for your vault

Practical tips for AI and Obsidian.

Unsubscribe anytime. Privacy