Mcp Bookmark

io.github.pree-dewPublished by GitHub account pree-dewv0.1.5Updated Oct 27, 2026

MCP Server for adding bookmarks in openai RAG

Overview

AI-generated overview

A local MCP server that lets an assistant save URL bookmarks with titles and descriptions and search them semantically using OpenAI RAG.

What you can do
  • Save bookmarks: store a URL with an optional title and description
  • Search bookmarks: run semantic queries across saved bookmark titles and descriptions
  • Use OpenAI embeddings for AI-powered categorization and search enhancement
When to use it
Useful when you want an assistant to keep a personal collection of links and later find them by meaning rather than exact keywords, for example saving a tutorial now and asking for it later.
Requirements
Runs locally as a Python package (mcp-bookmark-server) via uvx; needs Python 3.11+, an OpenAI API key supplied in the OPENAI_API_KEY environment variable, and internet access for GitHub repository access.
Before you install
Requires an OpenAI API key, and bookmark content is sent to OpenAI for categorization and semantic search, which may incur API usage costs. Saving bookmarks writes data to the local store.

Installation

In SourceWeft

  1. Open Mcp Bookmark in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

bash
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

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:

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:

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:

json
{  "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:

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:

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

search_bookmarks

Search through saved bookmarks.

Parameters:

  • query (required): Search terms

Example:

json
{  "query": "python tutorial"}

Usage Examples

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

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

License

MIT License


Built for the Model Context Protocol ecosystem

Source: README.md at commit 8857dd8

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.5LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.