Skip to content

Instantly share code, notes, and snippets.

@JoeHelbing
Created March 22, 2026 07:16
Show Gist options
  • Select an option

  • Save JoeHelbing/bd38b7111c9776ef7bcde11c7aa04b58 to your computer and use it in GitHub Desktop.

Select an option

Save JoeHelbing/bd38b7111c9776ef7bcde11c7aa04b58 to your computer and use it in GitHub Desktop.
Basic Memory + Obsidian Setup Guide for Windows 11
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Basic Memory + Obsidian Setup Guide</title>
<style>
@page { margin: 1in; size: letter; }
* { box-sizing: border-box; }
body {
font-family: 'Segoe UI', -apple-system, sans-serif;
line-height: 1.6;
color: #1a1a1a;
max-width: 7.5in;
margin: 0 auto;
padding: 40px 20px;
font-size: 14px;
}
h1 {
font-size: 28px;
border-bottom: 3px solid #7c3aed;
padding-bottom: 12px;
margin-bottom: 8px;
}
.subtitle {
color: #666;
font-size: 16px;
margin-bottom: 32px;
}
h2 {
font-size: 20px;
color: #7c3aed;
margin-top: 36px;
margin-bottom: 12px;
page-break-after: avoid;
}
h3 {
font-size: 16px;
margin-top: 20px;
margin-bottom: 8px;
page-break-after: avoid;
}
.step-number {
display: inline-block;
background: #7c3aed;
color: white;
width: 28px;
height: 28px;
border-radius: 50%;
text-align: center;
line-height: 28px;
font-weight: bold;
font-size: 14px;
margin-right: 8px;
}
.overview-box {
background: #f5f3ff;
border: 1px solid #ddd6fe;
border-radius: 8px;
padding: 16px 20px;
margin: 20px 0;
}
.overview-box h3 { margin-top: 0; color: #5b21b6; }
.overview-box ul { margin: 8px 0; padding-left: 20px; }
.warning-box {
background: #fefce8;
border: 1px solid #fde047;
border-radius: 8px;
padding: 12px 16px;
margin: 16px 0;
}
.warning-box strong { color: #a16207; }
.success-box {
background: #f0fdf4;
border: 1px solid #86efac;
border-radius: 8px;
padding: 12px 16px;
margin: 16px 0;
}
.success-box strong { color: #15803d; }
code {
background: #f1f5f9;
padding: 2px 6px;
border-radius: 4px;
font-family: 'Cascadia Code', 'Consolas', monospace;
font-size: 13px;
}
pre {
background: #1e293b;
color: #e2e8f0;
padding: 16px;
border-radius: 8px;
overflow-x: auto;
font-family: 'Cascadia Code', 'Consolas', monospace;
font-size: 13px;
line-height: 1.5;
page-break-inside: avoid;
}
pre code {
background: none;
padding: 0;
color: inherit;
}
.instruction {
margin: 12px 0;
padding-left: 4px;
}
ol, ul { padding-left: 24px; }
li { margin-bottom: 6px; }
img { max-width: 100%; }
.page-break { page-break-before: always; }
.checklist { list-style: none; padding-left: 4px; }
.checklist li { margin-bottom: 8px; }
.checklist li::before {
content: '\2610';
margin-right: 8px;
font-size: 16px;
}
.two-paths {
display: grid;
grid-template-columns: 1fr 1fr;
gap: 16px;
margin: 16px 0;
}
.path-option {
border: 2px solid #e2e8f0;
border-radius: 8px;
padding: 16px;
}
.path-option.recommended {
border-color: #7c3aed;
}
.path-option h4 { margin-top: 0; }
footer {
margin-top: 48px;
padding-top: 16px;
border-top: 1px solid #e2e8f0;
color: #888;
font-size: 12px;
}
</style>
</head>
<body>
<h1>Basic Memory + Obsidian Setup Guide</h1>
<p class="subtitle">For Windows 11 &mdash; Get Claude Desktop talking to your personal knowledge base</p>
<div class="overview-box">
<h3>What You're Setting Up</h3>
<ul>
<li><strong>Claude Desktop</strong> &mdash; The AI chat app (you already have the link for this)</li>
<li><strong>Basic Memory</strong> &mdash; A tool that gives Claude a persistent memory stored as plain text files</li>
<li><strong>Obsidian</strong> &mdash; A note-taking app that reads those same files, giving you a nice way to browse and edit your knowledge base</li>
</ul>
<p>The magic: Claude writes notes to a folder. Obsidian reads from that same folder. Everything stays in sync automatically.</p>
</div>
<div class="warning-box">
<strong>Before you start:</strong> Make sure you have an internet connection and about 20 minutes. You'll need to run some commands in PowerShell (Windows' built-in terminal).
</div>
<!-- ============================================================ -->
<h2><span class="step-number">1</span> Install Claude Desktop</h2>
<p>You should already have a link for this. Download and install it, then sign in with the account Joe set up for you.</p>
<p>If you don't have the link: go to <code>claude.ai/download</code> and grab the Windows version.</p>
<!-- ============================================================ -->
<h2><span class="step-number">2</span> Run the Automated Setup Script</h2>
<p>I've made a PowerShell script that installs everything else. Here's how to run it:</p>
<h3>Open PowerShell as Administrator</h3>
<ol>
<li>Right-click the <strong>Start button</strong> (Windows icon, bottom-left)</li>
<li>Click <strong>"Terminal (Admin)"</strong></li>
<li>If it asks "Do you want to allow this app to make changes?" click <strong>Yes</strong></li>
</ol>
<h3>Allow scripts to run (one-time)</h3>
<p>Paste this command and press Enter:</p>
<pre><code>Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser</code></pre>
<p>Type <code>Y</code> and press Enter if it asks you to confirm.</p>
<h3>Download and run the setup script</h3>
<p>Copy and paste this entire block into the terminal, then press Enter:</p>
<pre><code># Download the setup script
$setupUrl = "PASTE_RAW_URL_HERE"
$setupPath = "$env:TEMP\setup-basic-memory.ps1"
Invoke-WebRequest -Uri $setupUrl -OutFile $setupPath
# Run it
& $setupPath</code></pre>
<div class="warning-box">
<strong>Note for Joe:</strong> Replace <code>PASTE_RAW_URL_HERE</code> above with the actual URL where you host this script (e.g., a GitHub Gist raw URL or a file share link). Alternatively, your brother can skip the download step &mdash; just send him the <code>setup-basic-memory.ps1</code> file directly and have him run it from wherever he saves it.
</div>
<h3>If Joe sent you the script file directly</h3>
<p>Save the file <code>setup-basic-memory.ps1</code> somewhere (like your Desktop), then in the admin terminal:</p>
<pre><code># If saved to Desktop:
& "$env:USERPROFILE\Desktop\setup-basic-memory.ps1"</code></pre>
<p>The script will:</p>
<ul>
<li>Install Python 3.13 (if not already installed)</li>
<li>Install the <code>uv</code> package manager</li>
<li>Install Basic Memory</li>
<li>Configure Claude Desktop to connect to Basic Memory</li>
<li>Create the <code>C:\Users\YourName\basic-memory</code> folder</li>
<li>Install Obsidian (if not already installed)</li>
</ul>
<div class="success-box">
<strong>When it's done,</strong> the script will print "Setup Complete!" and tell you the remaining manual steps.
</div>
<!-- ============================================================ -->
<div class="page-break"></div>
<h2><span class="step-number">3</span> Restart Claude Desktop</h2>
<p>After the script finishes, you need to fully restart Claude Desktop so it picks up the new configuration:</p>
<ol>
<li>Find Claude in your system tray (bottom-right of screen, near the clock)</li>
<li>Right-click the Claude icon</li>
<li>Click <strong>Quit</strong></li>
<li>Open Claude Desktop again from the Start menu</li>
</ol>
<!-- ============================================================ -->
<h2><span class="step-number">4</span> Verify Basic Memory is Connected</h2>
<ol>
<li>In Claude Desktop, look at the chat input area</li>
<li>You should see a small <strong>tools icon</strong> (looks like a wrench or hammer)</li>
<li>Click it &mdash; you should see "basic-memory" tools listed</li>
<li>If you see them, type this message to Claude:</li>
</ol>
<pre><code>List my basic memory projects</code></pre>
<p>Claude should respond with something like:</p>
<pre><code>You have 1 project:
- main (default) - C:\Users\YourName\basic-memory - 0 notes</code></pre>
<div class="warning-box">
<strong>Don't see the tools?</strong> Make sure you fully quit and reopened Claude Desktop (not just closed the window). If it still doesn't work, see the Troubleshooting section at the end.
</div>
<!-- ============================================================ -->
<h2><span class="step-number">5</span> Set Up Obsidian</h2>
<ol>
<li>Open <strong>Obsidian</strong> (search for it in the Start menu)</li>
<li>If it's your first time, you'll see a welcome screen</li>
<li>Click <strong>"Open folder as vault"</strong></li>
<li>Navigate to <code>C:\Users\YourName\basic-memory</code>
<ul>
<li>In the folder picker, click on your username folder, then <code>basic-memory</code></li>
</ul>
</li>
<li>Click <strong>"Open"</strong> (or "Select Folder")</li>
<li>If Obsidian asks about "Trust this vault" or community plugins, click <strong>"Trust author and enable plugins"</strong> (or just "Trust")</li>
</ol>
<p>You now have Obsidian looking at the same folder that Basic Memory writes to.</p>
<!-- ============================================================ -->
<h2><span class="step-number">6</span> Test Everything Together</h2>
<p>Go back to Claude Desktop and type:</p>
<pre><code>Create a note called "Hello World" with a summary of what Basic Memory does and why it's useful.</code></pre>
<p>Now switch to Obsidian. You should see a new file called <strong>"Hello World"</strong> appear in the sidebar. Click on it to read it.</p>
<p>Try another one:</p>
<pre><code>Create a note about my favorite movies. I like sci-fi, especially Arrival and Blade Runner 2049.</code></pre>
<p>Check Obsidian again &mdash; another note should appear.</p>
<div class="success-box">
<strong>That's it! You're all set.</strong> Claude now has a persistent memory that you can browse, search, and edit in Obsidian. Notes are just regular text files on your computer.
</div>
<!-- ============================================================ -->
<div class="page-break"></div>
<h2>Troubleshooting</h2>
<h3>Claude Desktop doesn't show Basic Memory tools</h3>
<ol>
<li>Make sure you fully quit Claude (system tray > right-click > Quit), then reopen</li>
<li>Check the config file exists: open File Explorer, paste this in the address bar:
<pre><code>%APPDATA%\Claude\claude_desktop_config.json</code></pre>
</li>
<li>Open that file with Notepad and verify it looks like:
<pre><code>{
"mcpServers": {
"basic-memory": {
"command": "C:/Users/YourName/.local/bin/uvx.exe",
"args": ["basic-memory", "mcp"]
}
}
}</code></pre>
</li>
<li>If the <code>command</code> path doesn't point to a real file, open a terminal and type:
<pre><code>where uvx</code></pre>
Use whatever path that returns (with forward slashes <code>/</code> instead of backslashes <code>\</code>)
</li>
</ol>
<h3>"ENOENT" error in Claude Desktop logs</h3>
<p>This means Claude can't find the <code>uvx</code> command. Fix: replace <code>"uvx"</code> in the config with the full path to <code>uvx.exe</code>. The setup script tries to do this automatically, but if it didn't work, run <code>where uvx</code> in a terminal to find the path.</p>
<h3>Python isn't found after install</h3>
<p>Close your terminal completely and open a new one. Windows sometimes needs a fresh terminal to pick up new programs. If it still doesn't work, reinstall Python from <code>python.org</code> and make sure to check <strong>"Add Python to PATH"</strong> during installation.</p>
<h3>Obsidian doesn't show new notes</h3>
<p>Notes might take a moment to sync. Try clicking a different folder and back. Make sure you opened the correct folder: <code>C:\Users\YourName\basic-memory</code> (check there's a <code>main</code> subfolder inside it &mdash; notes go in there).</p>
<h3>Script fails partway through</h3>
<p>You can safely run the script again &mdash; it skips things that are already installed. If a specific step keeps failing, screenshot the error and send it to Joe.</p>
<!-- ============================================================ -->
<h2>Quick Reference</h2>
<table style="width:100%; border-collapse:collapse; margin-top:12px;">
<tr style="border-bottom: 2px solid #e2e8f0;">
<th style="text-align:left; padding:8px;">What</th>
<th style="text-align:left; padding:8px;">Where</th>
</tr>
<tr style="border-bottom: 1px solid #e2e8f0;">
<td style="padding:8px;">Your notes</td>
<td style="padding:8px;"><code>C:\Users\YourName\basic-memory\</code></td>
</tr>
<tr style="border-bottom: 1px solid #e2e8f0;">
<td style="padding:8px;">Claude config</td>
<td style="padding:8px;"><code>%APPDATA%\Claude\claude_desktop_config.json</code></td>
</tr>
<tr style="border-bottom: 1px solid #e2e8f0;">
<td style="padding:8px;">Claude Desktop</td>
<td style="padding:8px;">Start Menu > Claude</td>
</tr>
<tr style="border-bottom: 1px solid #e2e8f0;">
<td style="padding:8px;">Obsidian</td>
<td style="padding:8px;">Start Menu > Obsidian</td>
</tr>
</table>
<!-- ============================================================ -->
<h2>Checklist</h2>
<ul class="checklist">
<li>Claude Desktop installed and signed in</li>
<li>Setup script ran successfully</li>
<li>Claude Desktop restarted</li>
<li>Basic Memory tools visible in Claude</li>
<li>"List my basic memory projects" works</li>
<li>Obsidian opened with basic-memory vault</li>
<li>Test note created and visible in Obsidian</li>
</ul>
<footer>
Setup guide created for you by Joe. If anything goes wrong, just text him.
</footer>
</body>
</html>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment