whatisgithub

What is familiar-second-brain?

codejunkie99/familiar-second-brain — explained in plain English

Analysis updated 2026-05-18

18PythonAudience · developerComplexity · 2/5Setup · easy

In one sentence

A local Markdown vault plus MCP server that lets multiple AI assistants share notes and memory across sessions and tools.

Mindmap

mindmap
  root((Second Brain))
    What it does
      Shared note vault
      MCP server access
      Cross tool memory
    Tech stack
      Python
      MCP protocol
      Markdown
    Use cases
      Persist AI session context
      Daily brief generation
      Inbox triage
    Audience
      Developers
      Vibe coders
    Scripts
      Daily brief
      Note triage
      Duplicate audit
      Review resurfacing

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Share notes and context between Claude Code, Codex, Cursor, and other MCP compatible tools

USE CASE 2

Keep a persistent memory of AI session summaries in a local Markdown folder

USE CASE 3

Generate a daily brief pulling from recent sessions and inbox notes

USE CASE 4

Audit a note vault for duplicates and contradictions and resurface old notes for review

What is it built with?

PythonMCPMarkdown

How does it compare?

codejunkie99/familiar-second-brainandyuneducated/resolve-aicarriex6/cvpr2026_similarity_as_evidence
Stars181818
LanguagePythonPythonPython
Setup difficultyeasyhardhard
Complexity2/54/54/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Uses only Python's standard library, so no extra packages need installing, but each AI tool must support the MCP protocol.

License terms are not stated in the explanation, so treat usage rights as unclear until you check the repository directly.

So what is it?

Familiar Second Brain is a local server that lets AI assistants read and write notes to a Markdown folder on your computer. The folder acts as a shared memory store that multiple AI tools can access, so context you gather in one session does not get lost when the session ends or when you switch to a different tool. The system has three parts. The first is a Markdown vault: a folder on your machine where all notes live as plain .md files. The second is an MCP server, which is a small background program that exposes the vault to any application that speaks the MCP protocol, a standard that AI coding tools like Claude Code, Codex, and Cursor support. The third is a skill for a desktop AI app called Kimi Work, which lets that app save session summaries and conversation transcripts directly into the vault. Through the MCP server, connected tools can save a new note, search existing notes by keyword, read a specific file, or write to a file. Searches rank results by how well the keyword matches the title, tags, headings, links, and body text of each note, and return the surrounding context alongside the match. Beyond the live MCP tools, the project includes several Python scripts you can run on demand. One generates a daily brief pulling from recent sessions, transcripts, and inbox notes. Another triages notes that landed in an inbox folder, suggesting where to file them, what tags to add, and what other notes to link. A third generates per-project memory briefs. A fourth audits the vault for duplicate notes and contradictions. A fifth resurfaces older notes that are due for review. All of these write their output back into the vault as plain Markdown files. The project uses only Python's standard library, so there are no extra packages to install. Everything runs locally, and the repository deliberately excludes personal vault notes, API keys, and app databases.

Copy-paste prompts

Prompt 1
Show me how to set up this MCP server so Claude Code can read and write to my note vault
Prompt 2
Explain how the search ranking works when a connected tool looks up a note by keyword
Prompt 3
Walk me through running the daily brief script to summarize recent sessions
Prompt 4
Help me use the inbox triage script to file and tag new notes automatically

Frequently asked questions

What is familiar-second-brain?

A local Markdown vault plus MCP server that lets multiple AI assistants share notes and memory across sessions and tools.

What language is familiar-second-brain written in?

Mainly Python. The stack also includes Python, MCP, Markdown.

What license does familiar-second-brain use?

License terms are not stated in the explanation, so treat usage rights as unclear until you check the repository directly.

How hard is familiar-second-brain to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is familiar-second-brain for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.