Bear MCP Server
Read-only Model Context Protocol server for Bear note integration
Key Features
Use Cases
README
Bear MCP Server
A Model Context Protocol (MCP) server that allows AI assistants like Claude to read notes from the Bear note-taking app. This implementation connects directly to the Bear SQLite database in a read-only mode, ensuring your notes remain safe and unmodified.
Quick Start
Option 1: Install from GitHub (Recommended)
npx github:bart6114/my-bear-mcp-server
That's it! The server will start running and connect to your Bear database.
Option 2: Clone and Run Locally
# Clone the repository
git clone https://github.com/bart6114/my-bear-mcp-server.git
cd my-bear-mcp-server
# Install dependencies
npm install
# Build and run
npm run build
npm start
Prerequisites
- macOS with Bear app installed
- Node.js 18 or higher
Configuration
For Claude Desktop App
Add this to your configuration file at ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"bear": {
"command": "npx",
"args": ["github:bart6114/my-bear-mcp-server"],
"env": {},
"disabled": false,
"autoApprove": []
}
}
}
For Claude VS Code Extension
Add this to your configuration file at ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:
{
"mcpServers": {
"bear": {
"command": "npx",
"args": ["github:bart6114/my-bear-mcp-server"],
"env": {},
"disabled": false,
"autoApprove": []
}
}
}
Available Tools
The Bear MCP server provides these read-only tools (all operations are non-destructive and cannot modify your Bear database):
open_note
Open a note by title or ID.
search_notes
Search for notes by term or tag.
get_tags
Get all tags in Bear.
open_tag
Show all notes with a specific tag.
Example Usage
Here are examples of how to interact with the Bear MCP tools through AI assistants:
Searching for Notes
Ask your AI assistant to search for notes containing specific terms:
Can you find all my notes about "project management"?
Opening a Specific Note
Ask your AI assistant to retrieve a specific note by title:
Show me my note titled "Meeting Notes - March 2025"
Viewing Tags
Ask your AI assistant to list all your Bear tags:
What tags do I have in my Bear notes?
Finding Notes with a Specific Tag
Ask your AI assistant to show notes with a particular tag:
Show me all notes with the #work tag
Advanced Options
If your Bear database is in a non-standard location:
npx github:bart6114/my-bear-mcp-server --db-path /path/to/your/database.sqlite
Technical Details
Read-Only Implementation
This MCP server connects to your Bear SQLite database using a strict read-only connection. This is enforced at the database driver level:
// From src/bear-db.ts
this.db = new Database(dbPath, { readonly: true });
This ensures that:
- No write operations can be performed on your database
- Your notes and tags cannot be modified, deleted, or corrupted
- The database connection will fail if write permissions are attempted
All operations performed by this server are SELECT queries that only retrieve data without modifying it.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Star History
Repository Owner
User
Repository Details
Programming Languages
Tags
Join Our Newsletter
Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.
Related MCPs
Discover similar Model Context Protocol servers
Apple Notes MCP Server
Enables Claude Desktop to access and interact with local Apple Notes.
Apple Notes MCP Server reads and provides access to local Apple Notes databases for use in Claude Desktop. It allows querying all notes, retrieving specific note content, and searching notes, facilitating deeper context integration for AI workflows. The server operates under the Model Context Protocol (MCP) and is designed for straightforward installation and integration. Currently, it supports reading and searching but does not handle encrypted notes, attachments, or note creation/editing.
- ⭐ 121
- MCP
- sirmews/apple-notes-mcp
MCP Obsidian Server
Integrate Obsidian note management with AI models via the Model Context Protocol.
MCP Obsidian Server acts as a bridge between Obsidian and AI models by providing an MCP-compatible server interface. It enables programmatic access to Obsidian vaults through a local REST API, allowing operations like listing files, searching, reading, editing, and deleting notes. Designed to work with Claude Desktop and other MCP-enabled clients, it exposes a set of tools for efficient note and content management within Obsidian.
- ⭐ 2,394
- MCP
- MarkusPfundstein/mcp-obsidian
mcp-kibela
MCP server for secure, AI-assisted access to Kibela notes.
mcp-kibela is a Model Context Protocol (MCP) server implementation that enables AI assistants to search, retrieve, create, and update content from Kibela, a team knowledge-sharing platform. It provides standardized endpoints for note search, fetching individual or recent notes, and managing note content. Integrating with tools like Claude, Cursor, and VSCode, it allows seamless, secure access to organizational knowledge through MCP-enabled clients. Authentication via environment variables ensures secure connections to Kibela APIs.
- ⭐ 12
- MCP
- kj455/mcp-kibela
MCP Server for Asana
Bridge Asana's API with Model Context Protocol tools for seamless task management.
MCP Server for Asana provides a Model Context Protocol (MCP) compliant interface to the Asana API, enabling direct interaction with Asana from MCP clients such as Claude Desktop. It offers tools to list, search, retrieve, and create tasks and projects within Asana workspaces, with options for both read and write operations. The server supports advanced task filtering, project searching, and read-only modes for secure testing. Integration facilitates automation and streamlined project management within AI-powered environments.
- ⭐ 107
- MCP
- roychri/mcp-server-asana
attio-mcp-server
MCP server for enabling Attio CRM access via AI model context clients.
attio-mcp-server implements a Model Context Protocol (MCP) server that facilitates communication between MCP clients, such as Claude, and the Attio CRM API. It enables reading and writing company notes and records within Attio by leveraging a bearer token for authentication. Designed for Node.js, it provides streamlined integration with Attio for applications utilizing AI-driven model context protocols.
- ⭐ 16
- MCP
- hmk/attio-mcp-server
mcp-miro
Model Context Protocol server for integrating MIRO Whiteboard with AI workflows.
mcp-miro is a Model Context Protocol (MCP) compliant server that connects the MIRO Whiteboard Application to AI-based systems, such as Claude Desktop. It enables board manipulation, sticky note creation, bulk operations, and more through standardized MCP interfaces. Users can authenticate via OAuth and interact with MIRO boards programmatically for collaborative whiteboarding and automation tasks. The server can be installed using Smithery or mcp-get and supports debugging with the MCP Inspector.
- ⭐ 97
- MCP
- evalstate/mcp-miro
Didn't find tool you were looking for?