Mcp Bookmark

io.github.preedew17Published by GitHub account preedew17v0.1.0Updated Oct 24, 2026

An MCP server that provides [describe what your server does]

Overview

AI-generated overview

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

What you can do
Save bookmarks by URL with an optional title and description, stored with metadata for later retrieval. Search saved bookmarks by natural-language query, matching across titles and descriptions with semantic search. Use OpenAI to power categorization and search enhancement over the bookmark collection.
When to use it
Useful when you want an assistant to capture links you come across and later find them by meaning rather than exact keywords, for example collecting tutorials or development tools across a session.
Requirements
Runs locally as a Python package (Python 3.11+), typically launched through uvx. Needs an OpenAI API key supplied as the OPENAI_API_KEY environment variable, and an internet connection. The manifest declares a required secret named YOUR_API_KEY.
Before you install
Requires an OpenAI API key, which is a billable credential; bookmark titles, descriptions and search queries are sent to OpenAI for embedding and search. Saving bookmarks writes data to the local store. The README's configuration examples install the package directly from a GitHub repository, so review that source before running it.

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/preedew17/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/preedew17/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/preedew17/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/preedew17/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/preedew17/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 50482ad

Tools

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

Version history

1
  1. v0.1.0LatestSep 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.