Skip to main content

A MCP server for interacting with Bear note-taking software.

Project description

Bear MCP Server

uv Python Application pre-commit GitHub License

A MCP server for interacting with Bear note-taking software.

Bear MCP Server Icon

Installation

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

For Goose CLI

To enable the Bear extension in Goose CLI, edit the configuration 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 Goose Desktop

Add a new extension with the following settings:

  • Type: Standard IO
  • ID: bear
  • Name: Bear
  • Description: Interacting with Bear note-taking software
  • Command: uvx --from git+https://github.com/jkawamoto/mcp-bear mcp-bear
  • Environment Variables: Add BEAR_API_TOKEN with your api token

For more details on configuring MCP servers in Goose Desktop, refer to the documentation: Using Extensions - MCP Servers.

For Claude Desktop

Download the latest MCP bundle mcp-bear.mcpb from the Releases page, then open the downloaded .mcpb file or drag it into the Claude Desktop's Settings window.

You can also manually configure this server for Claude Desktop. Edit the claude_desktop_config.json file by adding the following entry under mcpServers:

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

After editing, restart the application. For more information, see: For Claude Desktop Users - Model Context Protocol.

For LM Studio

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

Add MCP Server bear to LM Studio

Actions Implemented

The server supports the following actions. Refer to Bear's X-callback-url Scheme documentation for 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

License

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iflow_mcp_jkawamoto_mcp_bear-0.5.2-py3-none-any.whl (10.2 kB view details)

Uploaded Python 3

File details

Details for the file iflow_mcp_jkawamoto_mcp_bear-0.5.2-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_jkawamoto_mcp_bear-0.5.2-py3-none-any.whl
  • Upload date:
  • Size: 10.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.27 {"installer":{"name":"uv","version":"0.9.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_jkawamoto_mcp_bear-0.5.2-py3-none-any.whl
Algorithm Hash digest
SHA256 bc0f63199b56f660a1640acc729d7e7d791e4c975cdbd26ec1e2667a7ab9509d
MD5 fc0510dcd2e4d2b6a0a93a6bc1e723b7
BLAKE2b-256 1a7d6692197c60598c7173c186934e58a0c202d5c96e884c367f64af26af4b4e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page