Bear MCP Server

What is Bear MCP Server?

Bear MCP Server is a Model Context Protocol server that enables AI assistants to interact with the Bear note-taking application. It translates MCP calls into Bear's x-callback-url actions, allowing automated note creation, editing, searching, and tag management.

How to use Bear MCP Server?

Install via uvx from the GitHub repository: uvx --from git+https://github.com/jkawamoto/mcp-bear mcp-bear. Provide your Bear API token either as the environment variable BEAR_API_TOKEN or via the command‑line flag --token. Configuration examples are available for Goose, Claude Desktop, and LM Studio; most setups require adding an MCP server entry pointing to the uvx command.

Key features of Bear MCP Server

• 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

Use cases of Bear MCP Server

• Automating note capture from an AI assistant
• Bulk organizing notes with tags and archiving
• Integrating Bear note‑taking into AI‑powered workflows
• Searching and retrieving notes contextually during conversations

FAQ from Bear MCP Server

What does Bear MCP Server do?

It connects AI assistants to Bear note‑taking software, enabling them to perform actions like creating notes, adding content, and managing tags using Bear’s x‑callback‑url scheme.

What are the system requirements?

You need uv installed on your system to use the uvx command. The Bear app must be installed locally on your computer.

How do I authenticate with Bear MCP Server?

Set the BEAR_API_TOKEN environment variable or pass your token via the --token command‑line argument when starting the server.

How can I install Bear MCP Server?

Use the uvx command with the GitHub repository URL. Detailed instructions for Goose, Claude Desktop, and LM Studio are provided in the README, including manual config file edits.

What actions are supported?

The server supports 16 actions from Bear’s x‑callback‑url scheme: open‑note, create, add‑text (partial), add‑file, tags, open‑tag, rename‑tag, delete‑tag, trash, archive, untagged, todo, today, locked, search, and grab‑url.