Skip to main content
Glama
Sign In

Bear MCP Server

by philgetzen
GitHub
JavaScript
MIT License
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Bear MCP Server

CI/CD License npm version

An MCP (Model Context Protocol) server for integrating Bear Note Taking App with Claude Desktop. This server allows Claude to read, create, and search your Bear notes directly.

✨ Features (v4.0.2)

Full data retrieval capabilities:

  • 🔍 Search notes and get complete results with metadata
  • 🏷️ Retrieve all tags from your Bear database
  • 📖 Read note content for analysis and summarization
  • ✏️ Create notes and get their IDs back
  • 📝 Add text to existing notes
  • ✅ Test setup with comprehensive status checking

⚠️ Current Limitations & Usage Guidelines

Browser Window Behavior

Expected: Brief browser windows may appear during search/tags operations due to Bear's callback system.

  • Windows are automatically minimized and moved off-screen
  • Auto-close within 1-2 seconds in most cases
  • Safe to manually close if they persist
  • Focus is returned to your original window automatically

Search Reliability

Success Rate: ~80-90% of searches work reliably

  • Occasional timeouts may occur (20-second limit)
  • Simple terms work better than complex queries
  • Retry once if a search times out
  • Single words tend to be more reliable than phrases

Best Practices

✅ Recommended Usage:

Search my Bear notes for "project" Get all my Bear tags Create a note titled "Meeting Notes" with today's agenda Add "Action item: Follow up" to my "Weekly Review" note

⚠️ If Issues Occur:

  • Timeouts: Wait a moment and retry the same search
  • Browser windows: Safe to close manually if they don't auto-close
  • No results: Try simpler/broader search terms
  • Setup issues: Use check_bear_setup to diagnose

Available Tools

ToolFunctionalityReliabilityNotes
create_noteCreates new notes✅ ExcellentAlways works, returns ID
add_textAdds text to notes✅ ExcellentReliable text addition
check_bear_setupTests configuration✅ ExcellentDiagnostic tool
search_notesSearches notes⚠️ Good~80-90% success, may timeout
get_tagsLists all tags⚠️ GoodUsually works, brief popup
get_noteRetrieves note content⚠️ GoodWorks well with valid IDs

Installation

  1. Clone the repository:
git clone https://github.com/philgetzen/bear-mcp.git cd bear-mcp
  1. Install dependencies:
npm install
  1. Build the project:
npm run build

Configuration in Claude Desktop

Add the server to your Claude Desktop configuration file:

macOS

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{ "mcpServers": { "bear": { "command": "node", "args": ["/path/to/bear-mcp/dist/index.js"] } } }

Windows

Edit %APPDATA%\Claude\claude_desktop_config.json:

{ "mcpServers": { "bear": { "command": "node", "args": ["C:\\path\\to\\bear-mcp\\dist\\index.js"] } } }

Bear Configuration

Required Settings:

  1. Enable x-callback-url:
    • Open Bear → Settings (⌘,)
    • Go to "Advanced" tab
    • Enable "Allow x-callback-url"
  2. Generate API Token (for search and tags):
    • Open Bear → Help → Advanced → API Token
    • Click "Copy Token"
    • In Claude, use: set_bear_token with your token

Usage Examples

Setup and Testing

Check my Bear setup and show me what's available

Reliable Operations (Always Work)

Create a new Bear note titled "Project Ideas" with content about machine learning Add "## Next Steps\n- Review documentation\n- Schedule follow-up" to my "Weekly Review" note

Search Operations (Usually Work)

Search my Bear notes for "machine learning" and show me what you find Get all my Bear tags and help me organize them

Content Analysis (When Search Works)

Search for "meeting notes" then help me identify common action items across all results Find notes tagged with "work" and summarize the main topics

Troubleshooting

"Search failed: Callback timeout"

  • Normal: Happens ~10-20% of the time
  • Solution: Wait 5-10 seconds and retry the same search
  • Tip: Try simpler search terms (single words work better)

"No token configured"

Get your token: Bear → Help → Advanced → API Token → Copy Token, then use set_bear_token

"Bear not found"

Make sure Bear is installed and has been opened at least once.

Browser windows appearing

  • Expected behavior due to Bear's callback system
  • Windows auto-minimize and move off-screen
  • Safe to manually close if they persist
  • Focus returns to your original window automatically

No search results

  • Check search term: Ensure it exists in your notes
  • Verify token: Use check_bear_setup to test
  • Try broader terms: Single words often work better than phrases
  • Check Bear directly: Verify the content exists in Bear app

Technical Details

HTTP Callback System

The server uses HTTP callbacks (port 51234) to receive data from Bear:

  • Bear sends search results and tag data via URL callbacks
  • Browser windows appear briefly due to this callback mechanism
  • 20-second timeout for Bear responses
  • Auto-retry mechanisms for common failures

Performance Characteristics

  • Fast operations: Note creation, text addition (~1-2 seconds)
  • Medium operations: Single note retrieval (~3-5 seconds)
  • Slower operations: Search, tags list (~5-15 seconds)
  • Timeout threshold: 20 seconds maximum wait

Development

To run in development mode:

npm run dev

To test the server:

npm run build node dist/index.js

Version History

  • v4.0.2: Enhanced browser window handling, 20s timeout
  • v4.0.1: Improved callback reliability, better error messages
  • v4.0.0: Full functionality restored with callback system
  • v3.1.0: Documentation-only version (limited functionality)

Requirements

  • Node.js 18 or higher
  • Bear app installed on your system
  • Claude Desktop application
  • macOS (Bear is macOS-only)

License

MIT

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

An MCP server that integrates Bear Note Taking App with Claude Desktop, allowing Claude to read, create, search notes and manage tags directly from Bear.

  1. ✨ Features (v4.0.2)
    1. ⚠️ Current Limitations & Usage Guidelines
      1. Browser Window Behavior
      2. Search Reliability
      3. Best Practices
    2. Available Tools
      1. Installation
        1. Configuration in Claude Desktop
          1. macOS
          2. Windows
        2. Bear Configuration
          1. Required Settings:
        3. Usage Examples
          1. Setup and Testing
          2. Reliable Operations (Always Work)
          3. Search Operations (Usually Work)
          4. Content Analysis (When Search Works)
        4. Troubleshooting
          1. "Search failed: Callback timeout"
          2. "No token configured"
          3. "Bear not found"
          4. Browser windows appearing
          5. No search results
        5. Technical Details
          1. HTTP Callback System
          2. Performance Characteristics
        6. Development
          1. Version History
            1. Requirements
              1. License

                Related MCP Servers

                • ClickUp Operator

                  noah-vh
                  -
                  security
                  F
                  license
                  -
                  quality
                  A Claude-compatible MCP server that enables storing and summarizing notes through a simple note storage system with custom URI scheme.
                  Last updated -
                  3
                  Python

                • Browser-use MCP Server

                  win4r
                  -
                  security
                  F
                  license
                  -
                  quality
                  A TypeScript-based MCP server that implements a simple notes system, allowing users to create, access, and generate summaries of text notes through Claude Desktop.
                  Last updated -
                  JavaScript
                  • Apple

                • NotesY

                  Rish-it
                  -
                  security
                  -
                  license
                  -
                  quality
                  A Claude MCP integration that allows seamless interaction with Apple Notes through natural language, enabling users to create, update, delete, and search notes.
                  Last updated -
                  TypeScript

                • Image Processor MCP Server

                  sanliunanjue
                  A
                  security
                  F
                  license
                  A
                  quality
                  A TypeScript-based MCP server that implements a simple notes system, allowing users to create, access, and generate summaries of notes via Claude Desktop integration.
                  Last updated -
                  2
                  1
                  JavaScript
                  • Apple

                View all related MCP servers

                New MCP Servers

                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/philgetzen/bear-mcp'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server