book-notes-mcp
Enables structured book note management in a GitHub repository with security-focused design, using GitHub for version control and repository hosting of the knowledge base content.
Supports GitHub Actions workflows for automated validation, formatting, and indexing of book notes with commit SHA pinning for security in the repository.
Utilizes SQLite with FTS5 for full-text search capabilities across Japanese and English content in the book notes database, enabling efficient querying of titles, authors, summaries, highlights, and concepts.
Manages structured book notes in YAML format with schema validation and formatting tools, providing a standardized way to organize book metadata, highlights, concepts, and connections.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@book-notes-mcpsearch for books about productivity and habits"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
book-notes-mcp
A knowledge base that manages business book notes in structured YAML, allowing AI agents to search and reference them via an MCP server.
Features
Zero dependency on LLM APIs ($0/month)
Security design based on public GitHub repositories
Japanese/English full-text search using SQLite FTS5
Accessible by AI agents via 7 MCP Tools
Quick Start
git clone https://github.com/YOUR_NAME/book-notes-mcp
cd book-notes-mcp
npm ci --ignore-scripts
# インデックスを構築
npm run index build
# Claude Desktop に MCP サーバーを登録
# ~/.config/claude/claude_desktop_config.json に追記:{
"mcpServers": {
"book-notes": {
"command": "npx",
"args": ["tsx", "/path/to/book-notes-mcp/mcp-server/src/index.ts"],
"env": { "DB_PATH": "/path/to/book-notes-mcp/books.db" }
}
}
}Usage
1. Structure your book notes
# inbox/ に走り書きを置く（gitignore対象）
cp your-notes.md inbox/
# 手元の AI CLI で YAML を生成
cat prompts/structure.md inbox/your-notes.md | claude > books/your-book-author-2024.yaml
# 検証・整形
npm run validate -- books/your-book-author-2024.yaml
npm run format -- books/your-book-author-2024.yaml
# インデックス更新
npm run index build2. CLI Commands
npm run validate -- books/ # スキーマ検証
npm run validate -- books/ --strict # 引用文字数エラーも検出
npm run format -- books/ # YAML 整形
npm run index build # SQLite インデックス構築
npm run check-refs # connections の参照整合性チェック3. MCP Tools
Tool | Description |
| List books with filters |
| Get details for a single book |
| Full-text search (title, author, summary) |
| Cross-reference search for highlights |
| Cross-reference search for concepts |
| Related book graph (depth 1 or 2) |
| Extract actionable items |
Book Entry YAML Format
Each YAML file in the books/ directory corresponds to one book.
Filename: {title-slug}-{author-family}-{year}.yaml (e.g., atomic-habits-clear-2018.yaml)
See schema/book-entry.schema.json for details.
Security
Raw notes in
inbox/are included in.gitignore(not included in public repositories)Registry-level malicious package blocking via Takumi Guard (npm.flatt.tech)
All GitHub Actions pinned by commit SHA
MCP server uses stdio only; SQLite is read-only
See SECURITY.md for details.
License
Code (
src/,mcp-server/,schema/): MIT LicenseContent (
books/,topics/): CC-BY-NC-4.0
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Agent-native MCP server over the public saagarpatel.dev corpus. Read-only, stateless.
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Serve a folder of Markdown notes as an MCP server: hybrid search, reading, and sourced answers.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/sotanengel/book-notes-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server