Skip to content

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

License

Notifications You must be signed in to change notification settings

jkawamoto/mcp-bear

Repository files navigation

Bear MCP Server

Python Application GitHub License pre-commit Ruff

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

Bear Server MCP server

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

To configure this server for Claude Desktop, edit the claude_desktop_config.json file with 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 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.

About

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

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Contributors 6

Languages