MCP Bookmark Server

A Model Context Protocol (MCP) server that enables AI assistants to save and search bookmarks using OpenAI's RAG capabilities. Store URLs with metadata and perform intelligent searches across your bookmark collection.

Features

Save Bookmarks: Store URLs with titles and descriptions
Smart Search: Search across bookmark titles and descriptions using semantic search
AI-Powered: Integration with OpenAI for intelligent bookmark management and categorization
Multi-Platform: Easy integration across multiple MCP-compatible platforms

Installation

pip install mcp-bookmark-server

Configuration for MCP Hosts

Claude Desktop

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "bookmark": {
      "command": "/usr/local/bin/uvx",
      "args": [
        "--from",
        "git+https://github.com/pree-dew/mcp-bookmark.git",
        "mcp-bookmark-server"
      ],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

Cursor IDE

Add to your MCP settings in .cursor/mcp_config.json:

{
  "mcpServers": {
    "bookmark": {
      "command": "/usr/local/bin/uvx",
      "args": [
        "--from",
        "git+https://github.com/pree-dew/mcp-bookmark.git",
        "mcp-bookmark-server"
      ],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

Windsurf IDE

Add to your windsurf_config.json:

{
  "mcpServers": {
    "bookmark": {
      "command": "/usr/local/bin/uvx",
      "args": [
        "--from",
        "git+https://github.com/pree-dew/mcp-bookmark.git",
        "mcp-bookmark-server"
      ],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

Zed Editor

Add to your Zed settings under MCP servers:

{
  "mcp": {
    "servers": {
      "bookmark": {
        "command": "/usr/local/bin/uvx",
        "args": [
          "--from",
          "git+https://github.com/pree-dew/mcp-bookmark.git",
          "mcp-bookmark-server"
        ],
        "env": {
          "OPENAI_API_KEY": "your-openai-api-key-here"
        }
      }
    }
  }
}

Continue (VS Code Extension)

Add to your continue/config.json:

{
  "mcpServers": [
    {
      "name": "bookmark",
      "command": "/usr/local/bin/uvx",
      "args": [
        "--from",
        "git+https://github.com/pree-dew/mcp-bookmark.git",
        "mcp-bookmark-server"
      ],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  ]
}

Available Tools

`save_bookmark`

Save a new bookmark.

Parameters:

url (required): The URL to bookmark
title (optional): Title for the bookmark
description (optional): Description

Example:

{
  "url": "https://example.com",
  "title": "Example Site",
  "description": "A useful example website"
}

`search_bookmarks`

Search through saved bookmarks.

Parameters:

query (required): Search terms

Example:

{
  "query": "python tutorial"
}

Usage Examples

Once configured with your MCP host, you can use natural language:

"Save this bookmark: https://python.org with title 'Python Official'"
"Search my bookmarks for React tutorials"
"Find bookmarks about machine learning"
"Save https://github.com/microsoft/vscode as a development tool bookmark"

Requirements

Python 3.11+
OpenAI API key
uvx package manager installed
Internet connection for GitHub repository access

Environment Variables

OPENAI_API_KEY: Required for AI-powered categorization and search enhancement

Support

Issues: GitHub Issues
MCP Documentation: Model Context Protocol

License

MIT License

Built for the Model Context Protocol ecosystem

mcp-bookmark

Documentation