home / mcp / bear app mcp server

Bear App MCP Server

Bear MCP server #Markdown #IOS #MCP

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "bigjeager-bear-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/bear-mcp-server/dist/index.js"
      ],
      "env": {
        "BEAR_TOKEN": "your-bear-api-token-here"
      }
    }
  }
}

You can run a Bear App MCP Server locally to enable your MCP clients to create, read, and manage Bear notes through the Bear X-callback-URL integration. This server provides practical note operations, search, tagging, organization, and web content capture, all accessible from your preferred MCP client.

How to use

Connect your MCP client to the Bear MCP Server to perform common note tasks. Use the available tools to create notes, open or modify existing notes, search by terms or tags, manage tags, and fetch special views like Today, Todo, or Untagged notes. You can also grab content from a URL to create a note with metadata. When operations return data, you receive full Bear note details, including IDs, titles, tags, dates, and content, enabling seamless follow-ups.

How to install

Prerequisites you need before installing are Node.js 18+ and Bear App installed on macOS. You should also have a Bear API token for operations that require authentication.

Step-by-step setup for development and running locally:

1) Give execute permissions to the setup script and run it.

chmod +x ./setup.sh && ./setup.sh

Additional setup notes

If you prefer manual installation, you can build from source and run the server directly from the built index.

Build and run steps typically involve installing dependencies, building the project, and then executing the built file.

Available tools

bear_open_note

Open a note by ID or title and receive full note data with metadata.

bear_create_note

Create a new Bear note with a title, content, and tags; returns the new note's ID and title.

bear_add_text

Add text to an existing note with options to append, prepend, or replace.

bear_search

Search notes by term and/or tag and return complete results with metadata.

bear_get_tags

Retrieve all available tags with full metadata.

bear_open_tag

Open notes that have a specific tag or set of tags, returning a detailed notes list.

bear_trash_note

Move a note to trash.

bear_archive_note

Archive a note to organize your library.

bear_get_untagged

Get notes that have no tags, returning the full list.

bear_get_todo

Get notes marked as todos with full metadata.

bear_get_today

Get today's notes with full details.

bear_rename_tag

Rename existing tags.

bear_delete_tag

Delete tags from Bear.

bear_grab_url

Create a note from the content of a web URL and return created note data.