---
title: "Turn chats into notes with obsidian-second-brain"
description: "Save ChatGPT, Claude and Gemini chats to a folder, then let obsidian-second-brain turn the ones that matter into linked notes in your vault."
url: https://chattomarkdown.com/docs/obsidian-second-brain/
version: "1.0.5"
updated: 2026-11-18
---

# Turn chats into notes with obsidian-second-brain

> obsidian-second-brain is a free tool for Claude Code that lets the AI keep notes in your Obsidian vault. It can't see your chats on ChatGPT, Claude.ai, Gemini and other sites. Chat to Markdown saves those chats as files in a folder. Then one command in Claude Code reads the chats you pick and writes what matters into your notes.

[obsidian-second-brain](https://github.com/eugeniughelbur/obsidian-second-brain) is a free tool for Claude Code. It also works in Codex, Gemini CLI, OpenCode and other AI coding tools. It lets the AI keep notes in your Obsidian vault: people, projects, decisions and tasks. The next time you start a session, the AI reads those notes, so you don't have to explain everything again.

It only sees what you do in Claude Code. It can't see your chats on ChatGPT, Claude.ai, Gemini, Grok or Perplexity. Chat to Markdown saves those chats as files, and obsidian-second-brain can read them from there.

The author of obsidian-second-brain wrote a guide for this setup: [Bring your chats from 5 AI websites into the vault](https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/AI-CHATS.md). This page covers the same steps, plus the Chat to Markdown settings to change.

## What each tool does

| | Chat to Markdown | obsidian-second-brain |
|---|---|---|
| **Saves** | Every chat, word for word, one file per chat | Short notes about your people, projects, decisions and tasks |
| **Where** | A folder on your computer | Your Obsidian vault |
| **When** | While you chat, and again when a chat goes on | When you run its command in Claude Code |

So you keep the full chats in one place, and only what matters ends up in your notes.

Chat to Markdown's files work well for this because:

- **Each chat is one plain Markdown file.** obsidian-second-brain reads it as it is. You don't need to convert anything.
- **Each file starts with the chat's details:** `title`, `source`, `url`, `id`, `model`, `created` and `updated` (see [What's in a saved file](https://chattomarkdown.com/docs/file-format/)). A note made from a chat can say which service, model and day it came from.
- **A chat keeps one file.** When you continue a chat, its file is updated. obsidian-second-brain notices the change the next time it reads the file.
- **The version history is ignored.** Chat to Markdown keeps it in a hidden `.chattomarkdown` folder, and obsidian-second-brain skips hidden folders.

## Set it up

1. **Install obsidian-second-brain.** Follow the [quick start in its README](https://github.com/eugeniughelbur/obsidian-second-brain#quick-start). You add it to Claude Code, tell it where your vault is, and run its setup command.
2. **Make a folder for your chats outside your vault.** For example, a folder named `ai-chats` in your home folder.
3. **Choose that folder in Chat to Markdown.** Do it on the welcome page, or in **Settings → Folder → Choose folder**. When Chrome asks, choose **Allow on every visit**. See [Choose your folder](https://chattomarkdown.com/docs/folder/).
4. **Change the settings in the next section.** Do this before you save any chats.
5. **Turn on only the chat services you want in your notes.** Use **Settings → Chat services**. See [Chat services](https://chattomarkdown.com/docs/services/).
6. **Save your chats.** Click **Save** on a chat, or let auto-save do it. See [How saving works](https://chattomarkdown.com/docs/how-saving-works/).

> [!NOTE]
> [Daily note links](https://chattomarkdown.com/docs/daily-notes/) and the **Open in Obsidian** buttons only work when Chat to Markdown saves into the vault itself. With a folder outside the vault, they are not available.

## Settings to change first

These settings keep files out of the folder that obsidian-second-brain shouldn't read. Change them before the first save, so you don't have to delete files later.

| Setting | Where | Set to | Why |
|---|---|---|---|
| **Images and files** | Settings → What to save | Off | obsidian-second-brain reads every picture and PDF in the folder as if it were a separate document. |
| **Artifacts as separate files** | Settings → What to save | Off | Documents Claude makes are then saved inside the chat's file, so they are read together with the chat. |
| **Hide secrets** | Settings → What to save | On | API keys and passwords are replaced with a label like `[hidden: OpenAI key]` before the file is saved, so they never reach your notes. |
| **Skip these projects** | Settings → Folders and filters | Projects you want to keep out | Chats in these projects or Spaces are never saved. Use it for chats that don't belong in your notes, such as work chats. |
| **Table of contents** | Settings → Obsidian | Off (the default) | If it's on, the list of all your chats would be read as a document too. |

More about each setting: [Choose what to save](https://chattomarkdown.com/docs/what-to-save/) and [How your files are organised](https://chattomarkdown.com/docs/folder-structure/#leave-chats-out).

## Add chats to your notes

obsidian-second-brain calls this **ingesting**: it reads a file, keeps a copy in your vault, and writes what it learned into your notes. You run the command in Claude Code (or in the other AI tool where you installed it).

The commands below use short names, as in the author's guide. If you installed it as a Claude Code plugin, type `/obsidian-second-brain:` first, for example `/obsidian-second-brain:obsidian-ingest`.

**1. See what's in the folder.** This only lists the files. It doesn't change anything:

```
/obsidian-ingest ~/ai-chats/ --preview
```

**2. Add one chat.** Start with a chat about something that matters to you:

```
/obsidian-ingest "~/ai-chats/ChatGPT/2026-10-02 Pricing page ideas.md"
```

**3. Or add the whole folder, a few chats at a time.** This adds 5 chats. Run the same command again for the next 5:

```
/obsidian-ingest ~/ai-chats/ --batch-size 5
```

For each chat, obsidian-second-brain saves a copy in the `raw` folder of your vault, then shows you the changes it wants to make to your notes. It never changes the file in your chats folder.

### What to expect

- **It doesn't fully trust AI chats.** An AI answer doesn't say where its facts come from, so obsidian-second-brain marks chats as the least reliable kind of source. A chat can add new notes, but it won't change a note you already have until you approve it. Facts taken from a chat are marked `(confidence: speculation)`.
- **What you wrote matters more than what the AI wrote.** "I signed the contract on Monday" is a fact from you. "I made two files for you" is only the AI's claim. In each file, `## You` marks your messages, so you can ask Claude Code to keep the two apart in your notes.
- **Most chats don't need to be in your notes.** A recipe or a quick translation adds nothing. Add the chats about a project, a decision or a plan. The rest stay in your folder, and you can still find them with [Search](https://chattomarkdown.com/docs/search/) and the [reader](https://chattomarkdown.com/docs/reader/).

## Limits

These come from how obsidian-second-brain works today. The author's guide has the [full list](https://github.com/eugeniughelbur/obsidian-second-brain/blob/main/AI-CHATS.md#limits-today).

- **Folders with some names are skipped.** When you add a whole folder, it skips any folder named `raw`, `wiki`, `logs`, `research`, `bases` or `boards`. So a ChatGPT project called "Research" is skipped. Rename the project, or add its chats one at a time.
- **A chat you keep using is copied again.** Each time the chat's file changes, the next run saves another copy. Add a chat when you're done with it, not while you're still chatting.
- **Add one folder at a time.** Don't run two folder commands on the same vault at once.

## Privacy

- Chat to Markdown saves chats straight to your folder. They are not sent to our server. See [Privacy and permissions](https://chattomarkdown.com/docs/privacy/).
- Claude Code (or your other AI tool) reads the chats you add. They go to the AI model it uses, the same as any file you give it.
- Chats you add end up in your vault. If your vault syncs or is backed up, they go there too.
- A ChatGPT temporary chat, a Claude incognito chat or a Grok private chat has `private: true` at the top of its file (see [The Save button](https://chattomarkdown.com/docs/save-button/)). Leave those out.

## Questions

### Do I need obsidian-second-brain to use Chat to Markdown with Obsidian?

No. Chat to Markdown saves chats as Obsidian notes on its own. obsidian-second-brain is for people who also want Claude Code to read their chats and update their notes from them.

### Why should the chats folder be outside the vault?

When obsidian-second-brain reads a chat, it saves its own copy in the vault. With the chats folder outside, the vault doesn't hold every chat twice, and its health check doesn't flag the chat files.

### Does obsidian-second-brain change my saved chat files?

No. It only reads them. Chat to Markdown keeps updating each file as the chat goes on.

### Does it cost anything?

obsidian-second-brain is free. Chat to Markdown is free for 10 chats, and Pro saves all of them. See Free and Pro.
