Skip to main content
Glama

🐿️ SquirrelMap — 3D Idea Mindmap & Sourcing Graph

Stash your ideas, connect your hardware, and bulk-buy your parts.
SquirrelMap is an interactive 3D capability & project mindmap where every idea is backed by an individual, human-and-agent-readable local Markdown file (ideas/<id>.md) with YAML frontmatter, Bill of Materials (BOM), and relationship links.


🌟 Highlights

  • 🐿️ Stash Ideas Easily: Enter a rough thought or speak with the agent; SquirrelMap automatically categorizes your idea, extracts or estimates required hardware components, and creates a local Markdown file.

  • 🛒 Cross-Project BOM Sourcing: Identifies common parts across your builds (e.g. RP2040 microcontrollers, Noctua fans, Neodymium magnets) and computes consolidated bulk-buy recommendations so you can order hardware efficiently.

  • 📝 Markdown Source of Truth: Each idea is stored as a clean .md file in ideas/. Edit notes directly in the Web UI using the built-in Markdown editor with live preview, or edit externally in Obsidian / VSCode.

  • 🤖 Autonomous MCP Agent: Connects via Model Context Protocol (squirrelmap) to Antigravity / Gemini models without requiring any API keys.


Related MCP server: Obsidian Project Management MCP Server

🚀 Quick Launch

From Desktop Menu

Search for SquirrelMap in your KDE Plasma Start / Kickoff menu or KRunner (Alt+Space).

From Terminal

/home/rec0il/Dokumente/Scritps/SquirrelMap/launch.sh

Direct Server

cd /home/rec0il/Dokumente/Scritps/SquirrelMap
python3 run.py

Open http://localhost:8766 in your browser.


🛠️ MCP Agent Tools (squirrelmap)

Tool

Description

mindmap_add_idea

Stash a new project with auto-categorization and BOM indexing

mindmap_get_idea

Read complete Markdown notes, frontmatter, BOM, and links

mindmap_update_idea

Update notes, BOM items, tags, category, or status

mindmap_list_ideas

Filter stashed ideas by category, status, or search query

mindmap_link_ideas

Connect projects (shared_bom, synergy, depends_on, subproject)

mindmap_find_similarities

Scan for hardware overlap and creative synergies

mindmap_analyze_bom

Cross-project BOM aggregator with bulk-buy recommendations

mindmap_fuse_ideas

Merge two overlapping ideas into one consolidated project

mindmap_split_idea

Split a complex project into modular sub-projects

mindmap_get_graph_stats

Summary stats of ideas, categories, and connection density


📦 Desktop Installers & Releases

SquirrelMap is wrapped with Electron and packaged into native installers for Linux, Windows, and macOS:

Platform

Format

Details

Linux

.deb, .rpm, .AppImage

Native Debian/Ubuntu package, RedHat/Fedora RPM, and standalone AppImage

Windows

.exe

NSIS Desktop Setup Installer (x64)

macOS

.dmg, .zip

Apple Disk Image and standalone archive

Every tagged release (v*) triggers automated GitHub Actions workflows that compile the standalone Python backend with PyInstaller, bundle the Electron frontend, and publish installer artifacts directly to GitHub Releases.

Local Desktop Development (Electron)

# Install dependencies
npm install

# Run Electron app
npm start

# Build local installers
npm run dist:linux   # Builds .deb, .rpm, .AppImage
npm run dist:win     # Builds Windows NSIS installer
npm run dist:mac     # Builds macOS DMG and ZIP

📄 License

Distributed under the MIT License. Copyright © 2026 Rec0iL.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Provides semantic search and a tag-based knowledge graph for any project, auto-discovering local markdown knowledge bases with YAML frontmatter.
    10
    16 npm
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI assistants to create, update, search, and manage project entities (milestones, stories, tasks, decisions, documents, features) stored as markdown files in Obsidian with automatic relationship tracking and progress overview.
    7 npm
    MIT
  • F
    license
    Not graded
    quality
    A
    maintenance
    Enables users to create timestamped atomic notes in Markdown, bidirectionally link and tag them into a searchable knowledge graph, and explore, synthesize, or discover relationships among ideas through Claude and other MCP-compatible clients. Notes are stored as human-readable files with an SQLite index that supports finding similar, central, and orphaned notes.
    -
  • F
    license
    Not graded
    quality
    A
    maintenance
    Enables creating, linking, searching, and synthesizing atomic notes stored as human-readable Markdown files with a rebuildable SQLite index, forming a navigable knowledge graph through typed semantic relationships, tags, and distinct note types. It lets Claude and other MCP-compatible clients capture fleeting ideas, explore linked notes across domains, and surface central, similar, or orphaned notes for further synthesis.
    -