Bear

by jkawamoto

46 stars
424 downloads
Not rated
GitHub

About

Integrates with Bear note-taking software to enable note creation, search, and organization operations for enhanced knowledge management.

Details

Author
jkawamoto
Repository
jkawamoto/mcp-bear
GitHub stars
46
Downloads
424
License
MIT License
Categories
Productivity, Other, AI, Design, Developer Tools, Search, Frontend, Automation, API
Tags
#mobile

- Opens, creates, and archives Bear notes
- Adds text and files to existing notes
- Retrieves and manages tags (create, rename, delete)
- Searches notes and grabs URLs
- Lists notes by criteria: todo, today, locked, untagged

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Bear
    Command (node, npx, python, etc.) uvx
    Arguments
    • Argument 1 --from
    • Argument 2 git+https://github.com/jkawamoto/mcp-bear
    • Argument 3 mcp-bear
    • Argument 4 --token
    • Argument 5 <YOUR_TOKEN>
    Environment
    • BEAR_API_TOKEN <YOUR_TOKEN>

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

> [!NOTE]
> You'll need uv installed on your system to use uvx command.

/open-note

Open a specific note in Bear.

/create

Create a new note in Bear.

/add-text

Add text to a note (partially, via the replace_note and add_title method).

/add-file

Add a file to a note in Bear.

/tags

Retrieve all tags in Bear.

/open-tag

Open a specific tag in Bear.

/rename-tag

Rename an existing tag in Bear.

/delete-tag

Delete a specific tag from Bear.

/trash

Move a note to the trash in Bear.

/archive

Archive a note in Bear.

/untagged

Retrieve all untagged notes in Bear.

/todo

Retrieve all todo items in Bear.

/today

Retrieve notes created today in Bear.

/locked

Retrieve locked notes in Bear.

/search

Search for notes in Bear.

/grab-url

Grab a URL and create a note from it in Bear.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "bear": {
            "env": {
                "BEAR_API_TOKEN": "<YOUR_TOKEN>"
            },
            "args": [
                "--from",
                "git+https://github.com/jkawamoto/mcp-bear",
                "mcp-bear",
                "--token",
                "<YOUR_TOKEN>"
            ],
            "command": "uvx"
        }
    }
}

Linux

{
    "env": {
        "BEAR_API_TOKEN": "<YOUR_TOKEN>"
    },
    "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-bear",
        "mcp-bear",
        "--token",
        "<YOUR_TOKEN>"
    ],
    "command": "uvx"
}

Macos

{
    "env": {
        "BEAR_API_TOKEN": "<YOUR_TOKEN>"
    },
    "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-bear",
        "mcp-bear",
        "--token",
        "<YOUR_TOKEN>"
    ],
    "command": "uvx"
}

Windows

{
    "env": {
        "BEAR_API_TOKEN": "<YOUR_TOKEN>"
    },
    "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-bear",
        "mcp-bear",
        "--token",
        "<YOUR_TOKEN>"
    ],
    "command": "uvx"
}

[!NOTE] This repository is archived. As ofv2.8, Bear now includes a nativeMCP server implementation, making this standalone server unnecessary.

A MCP server for interacting withBearnote-taking software.

[!NOTE] You'll needuvinstalled on your system to useuvxcommand.

goose://extension?cmd=uvx&arg=--from&arg=git%2Bhttps%3A%2F%2Fgithub.com%2Fjkawamoto%2Fmcp-bear&arg=mcp-bear&id=bear&name=Bear&description=Interacting%20with%20Bear%20note-taking%20software&env=BEAR_API_TOKEN

to launch the installer, then click "Yes" to confirm the installation. SetBEAR_API_TOKENenvironment variable to your api token.

You can also directly edit the config file (~/.config/goose/config.yaml) to include the following entry:

extensions: bear: name: Bear cmd: uvx args: [--from, git+https://github.com/jkawamoto/mcp-bear, mcp-bear] envs: { "BEAR_API_TOKEN": "<YOUR_TOKEN>" } enabled: true type: stdio

For more details on configuring MCP servers in Goose, refer to the documentation:Using Extensions | goose.

Download the latest MCP bundlemcp-bear.mcpbfrom theReleasespage, then open the downloaded.mcpbfile or drag it into the Claude Desktop's Settings window.

You can also manually configure this server for Claude Desktop. Edit theclaude_desktop_config.jsonfile by adding the following entry undermcpServers:

{ "mcpServers": { "bear": { "command": "uvx", "args": [ "--from", "git+https://github.com/jkawamoto/mcp-bear", "mcp-bear", "--token", "<YOUR_TOKEN>" ] } } }

For more information, see:Connect to local MCP servers - Model Context Protocol.

To configure this server for LM Studio, click the button below.

The server supports the following actions. Refer to Bear'sX-callback-url Scheme documentationfor details on each action.

- /open-note
- /create
- /add-text (partially, via the replace_note and add_title method)
- /add-file
- /tags
- /open-tag
- /rename-tag
- /delete-tag
- /trash
- /archive
- /untagged
- /todo
- /today
- /locked
- /search
- /grab-url

This application is licensed under the MIT License. See theLICENSEfile for more details.

Multi-device file sync, dev-doc CRUD, task management, and session handoffs for AI agents - MCP + OpenAPI dual surface.

Access and manage your library on Apple Books.

Interact with Apple Notes using natural language on macOS.

MCP server for Apple Notes with semantic search and CRUD operations. Claude searches, reads, creates, updates, and manages your Apple Notes through natural language.

Provides direct access to your Bear notes database for comprehensive note management, bypassing standard API limitations.

Allows AI assistants to read notes from the Bear note-taking app by connecting directly to its SQLite database.

Access and manage your notes from the Bear App.

Integrates Model Context Protocol (MCP) with Obsidian, allowing AI assistants to interact with your notes and vault.

Markdown-first Notion MCP server — 26 tools, 92% fewer tokens, full round-trip fidelity

A simple notes system for Itemit, built with TypeScript.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.