Bookmarks
БесплатноНе проверенBrowser bookmarks automation via FastMCP — search, organize, RAG-friendly export. For Cursor / Claude Desktop.
Описание
Browser bookmarks automation via FastMCP — search, organize, RAG-friendly export. For Cursor / Claude Desktop.
README
📖 Installation Guide — quick start, manual setup, and troubleshooting
FastMCP 3.3 MCP server with multiple portmanteau tools (not one mega bookmarks tool). Ported from database-operations-mcp.
MCP Tools (portmanteau surfaces)
| Tool | Purpose |
|---|---|
browser_bookmarks |
Universal CRUD/search/export across Firefox, Chrome, Edge, Brave |
firefox_profiles |
Firefox profile create/load/portmanteau profiles |
firefox_backup |
Backup/restore Firefox profile data |
firefox_curated |
Curated bookmark source collections |
firefox_tagging |
Folder/year-based auto-tagging |
firefox_utils |
Firefox paths, lock checks, places DB info |
sync_bookmarks |
Cross-browser sync (dry-run supported) |
chrome_profiles |
Chromium profile management |
ai_bookmark_portmanteau |
AI categorize, dedupe, curate, maintain, export |
firefox_bookmarks remains an internal helper used by browser_bookmarks for Firefox-specific SQLite operations.
Quick Start
git clone https://github.com/sandraschi/bookmarks-mcp
cd bookmarks-mcp
just
This opens an interactive dashboard showing all available commands. Run just bootstrap to install dependencies, then just serve or just dev to start.
Installation
Prerequisites
- uv installed (RECOMMENDED)
- Python 3.12+
Quick Start
Run immediately via uvx:
uvx bookmarks-mcp
Claude Desktop Integration
Add to your claude_desktop_config.json:
"mcpServers": {
"bookmarks-mcp": {
"command": "uv",
"args": ["--directory", "D:/Dev/repos/bookmarks-mcp", "run", "bookmarks-mcp"]
}
}
Running the Server
As a Python Module (Recommended for MCP clients)
python -m browser_bookmarks_tools
As a Direct Script (Development)
python src/browser_bookmarks_tools/mcp_server.py
With uv
uv run python -m browser_bookmarks_tools
MCP Client Configuration
Cursor IDE (mcp.json)
{
"mcpServers": {
"bookmarks-mcp": {
"command": "python",
"args": ["-m", "browser_bookmarks_tools"],
"env": {
"PYTHONPATH": "D:/Dev/repos/bookmarks-mcp/src",
"PYTHONUNBUFFERED": "1"
}
}
}
}
Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"bookmarks-mcp": {
"command": "python",
"args": ["-m", "browser_bookmarks_tools"],
"env": {
"PYTHONPATH": "/path/to/bookmarks-mcp/src"
}
}
}
}
Available Operations
See tool docstrings for full operation lists. Primary entry points:
browser_bookmarks—list_bookmarks,add_bookmark,search_bookmarks,find_duplicates,export_bookmarks, tag ops, age analysis, broken links, etc.sync_bookmarks— cross-browser transfer withdry_runai_bookmark_portmanteau—categorize,dedupe,curate,maintain,export
Browser Support Details
Firefox (Primary)
- Storage:
places.sqlitedatabase - Features: Full history, tags, folders, favicons
- Path:
~/.mozilla/firefox/*/places.sqlite
Chrome/Edge/Brave
- Storage: JSON bookmark files
- Features: Basic bookmarks with folders
- Path:
~/Library/Application Support/Google/Chrome/Default/Bookmarks
Safari (macOS only)
- Storage: Binary plist files
- Features: Basic bookmarks
- Path:
~/Library/Safari/Bookmarks.plist
Development
Project Structure
bookmarks-mcp/
src/browser_bookmarks_tools/
__init__.py # Package initialization
__main__.py # Module entry point for `python -m`
mcp_server.py # FastMCP server implementation
bookmarks/ # Core bookmark operations
manager.py # CRUD operations
organizer.py # Organization features
portmanteau.py # Main tool interface
sync.py # Cross-browser sync
ai/ # AI-powered features
analyzer.py # Content analysis
summarizer.py # Summary generation
tagger.py # Smart tagging
browsers/ # Browser-specific implementations
tests/
pyproject.toml
Running Tests
python -m pytest tests/
Code Quality
# Format code
black src/
# Lint code
ruff check src/
# Type checking
mypy src/
Troubleshooting
"Module not found" errors
Ensure PYTHONPATH includes the src directory:
export PYTHONPATH="/path/to/bookmarks-mcp/src:$PYTHONPATH"
Browser permission issues
- Firefox: Ensure Firefox is not running when accessing
places.sqlite - Chrome/Edge: No special permissions needed for reading bookmark files
- Safari: Requires macOS and appropriate file permissions
MCP connection issues
- Verify the server starts without errors when run manually
- Check that
PYTHONPATHis correctly set in your MCP client configuration - Ensure no firewall/antivirus is blocking the connection
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests for new functionality
- Submit a pull request
🛡️ Industrial Quality Stack
This project adheres to SOTA 14.1 industrial standards for high-fidelity agentic orchestration:
- Python (Core): Ruff for linting and formatting. Zero-tolerance for
printstatements in core handlers (T201). - Webapp (UI): Biome for sub-millisecond linting. Strict
noConsoleLogenforcement. - Protocol Compliance: Hardened
stdout/stderrisolation to ensure crash-resistant JSON-RPC communication. - Automation: Justfile recipes for all fleet operations (
just lint,just fix,just dev). - Security: Automated audits via
banditandsafety.
License
[Add appropriate license information]
Changelog
v0.1.0
- Initial FastMCP 3.1.0 compliant implementation
- Firefox, Chrome, Edge, Brave, and Safari support
- Unified portmanteau tool interface
- AI-powered bookmark analysis and tagging
- Cross-browser synchronization
Web dashboard
| Service | Port | Notes |
|---|---|---|
| Frontend (Vite) | 10802 | web_sota/start.ps1 |
| Backend (FastAPI + MCP) | 10803 | MCP_TRANSPORT=http |
Pages: Dashboard, Bookmarks (CRUD + pagination), Search (folder/tag filters), Tree, Bulk ops (sync wizard, export download), Tags, AI Command, MCP Tools, Settings, Help.
The web API has no authentication — it's a local dashboard over your own browser bookmarks, not a multi-tenant service. Bind it to localhost (the default) unless you have another reason to expose it on the network.
Tauri desktop
cd native
.\build.ps1
Spawns the MCP backend sidecar on 10803 and loads the built SPA.
Webapp Dashboard
This MCP server includes a React web interface for monitoring and control. By default, the web dashboard runs on port 10802. (Assigned ports: 10802 (Web dashboard frontend), 10803 (Web dashboard backend))
To start the webapp:
- Navigate to the
webapp(orweb,frontend) directory. - Run
start.bat(Windows) or./start.ps1(PowerShell). - Open
http://localhost:10802in your browser.
Установка Bookmarks
У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.
▸ github.com/sandraschi/bookmarks-mcpFAQ
Bookmarks MCP бесплатный?
Да, Bookmarks MCP бесплатный — установка в пару кликов через Unyly без оплаты.
Нужен ли API-ключ для Bookmarks?
Нет, Bookmarks работает без API-ключей и переменных окружения.
Bookmarks — hosted или self-hosted?
Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.
Как установить Bookmarks в Claude Desktop, Claude Code или Cursor?
Открой Bookmarks на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.
Похожие MCP
Playwright
Browser automation, scraping, screenshots
автор: MicrosoftPuppeteer
Browser automation and web scraping.
автор: modelcontextprotocolGarmin Connect
An MCP server for Garmin Connect that provides access to fitness activities, health statistics, and sleep data by routing requests through a headless browser to
автор: etweisbergHiggsfield Unlimited
MCP server for Higgsfield AI that enables unlimited-mode image, video, audio generation, uploads, and job management via multiple parallel accounts, using brows
автор: nukIeeropentabs-dev/opentabs
Plugin-based server and Chrome extension that gives AI agents access to web apps through your authenticated browser session, with a plugin SDK.
автор: opentabs-devhlydecker/ucsc-genome-mcp
Interact with the UCSC Genome Browser API to find genomes, chromosomes and more.
автор: hlydecker34892002/bilibili-mcp-js
Search Bilibili content, with LangChain integration examples.
автор: 34892002achiya-automation/safari-mcp
Native Safari browser automation without a Chrome dependency.
автор: achiya-automationagent-infra/mcp-server-browser
Browser automation using Puppeteer, supporting local and remote browser connections.
автор: bytedanceaparajithn/agent-scraper-mcp
Web scraping: clean content extraction, CSS-selector scraping, Playwright screenshots, link and metadata extraction, and Google search.
автор: aparajithnCompare Bookmarks with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории browse
