https://github.com/jkawamoto/mcp-bear
A MCP server for interacting with Bear note-taking software.
https://github.com/jkawamoto/mcp-bear
mcp-server python x-callback-url
Last synced: 4 months ago
JSON representation
A MCP server for interacting with Bear note-taking software.
- Host: GitHub
- URL: https://github.com/jkawamoto/mcp-bear
- Owner: jkawamoto
- License: mit
- Created: 2025-02-12T08:27:18.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-02-26T08:50:48.000Z (4 months ago)
- Last Synced: 2025-02-26T09:34:35.545Z (4 months ago)
- Topics: mcp-server, python, x-callback-url
- Language: Python
- Homepage:
- Size: 49.8 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- mcp-index - Bear MCP Server - Interact with Bear note-taking software to manage notes and retrieve information. Provides integration with Bear's API for note creation and manipulation. (APIs and HTTP Requests)
README
> [!IMPORTANT]
> This application is currently under development. A known issue exists where **a browser opens for every API call**.
# Bear MCP Server
[](https://github.com/jkawamoto/mcp-bear/actions/workflows/python-app.yaml)
[](https://github.com/jkawamoto/mcp-bear/blob/main/LICENSE)
[](https://github.com/pre-commit/pre-commit)
[](https://github.com/astral-sh/ruff)
[](https://smithery.ai/server/@jkawamoto/mcp-bear)
A MCP server for interacting with [Bear](https://bear.app/) note-taking software.
## Installation
### For Claude Desktop
To configure this server for Claude Desktop, edit the `claude_desktop_config.json` file with the following entry under
`mcpServers`:
```json
{
"mcpServers": {
"youtube-transcript": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/jkawamoto/mcp-bear",
"mcp-bear",
"--token",
""
]
}
}
}
```
After editing, restart the application.
For more information,
see: [For Claude Desktop Users - Model Context Protocol](https://modelcontextprotocol.io/quickstart/user).
### For Goose CLI
To enable the Bear extension in Goose CLI,
edit the configuration file `~/.config/goose/config.yaml` to include the following entry:
```yaml
extensions:
bear:
name: Bear
cmd: uvx
args: [--from, git+https://github.com/jkawamoto/mcp-bear, mcp-bear]
envs: { "BEAR_API_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](https://block.github.io/goose/docs/getting-started/using-extensions#mcp-servers).
### Installing via Smithery
To install Bear MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@jkawamoto/mcp-bear):
```bash
npx -y @smithery/cli install @jkawamoto/mcp-bear --client claude
```
## Actions Implemented
The server supports the following actions.
Refer to Bear's [X-callback-url Scheme documentation](https://bear.app/faq/x-callback-url-scheme-documentation/) for details on each action.
- [x] /open-note
- [x] /create
- [ ] /add-text
- [ ] /add-file
- [x] /tags
- [x] /open-tag
- [ ] /rename-tag
- [ ] /delete-tag
- [ ] /trash
- [ ] /archive
- [ ] /untagged
- [x] /todo
- [x] /today
- [ ] /locked
- [x] /search
- [x] /grab-url
## License
This application is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.