How do I use Bookmark Manager MCP?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Bookmark Manager MCP add https://github.com to my development bookmarks" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Bookmark Manager MCP

by infinitepi-io

Overview Schema Source Related Servers Discussions Admin

TypeScript

Hybrid

🔖 Bookmark Manager MCP

A Model Context Protocol (MCP) server for managing bookmarks with persistent storage

📋 Overview

This MCP server provides a simple yet powerful bookmark management system that integrates seamlessly with Claude and other MCP-compatible clients. It offers persistent storage, categorization, and easy retrieval of your bookmarks.

Related MCP server: Memory MCP Server

✨ Features

📁 Persistent Storage: Bookmarks are saved to ~/.data/bookmarks.json
🏷️ Categories: Organize bookmarks with custom categories
🔍 Resource Discovery: Browse bookmarks by category using MCP resources
🐳 Container Support: Ready-to-use container image (Docker/Podman)
⚡ TypeScript: Type-safe implementation with Zod validation
🔗 MCP Integration: Full Model Context Protocol compliance

🛠️ Installation

🔧 Claude Code Integration

# Add to Claude Code (Docker)
docker pull mindriftfall2infinitepiio/bookmark-manager-mcp:latest
claude mcp add bookmark-manager -- docker run \
    --rm \
    --interactive \
    --volume ~/.data:/app/.data \
    mindriftfall2infinitepiio/bookmark-manager-mcp:latest

# Or with Podman
podman pull mindriftfall2infinitepiio/bookmark-manager-mcp:latest
claude mcp add bookmark-manager -- podman run \
    --rm \
    --interactive \
    --volume ~/.data:/app/.data \
    mindriftfall2infinitepiio/bookmark-manager-mcp:latest

🔧 VS Code Integration

# Docker
docker pull mindriftfall2infinitepiio/bookmark-manager-mcp:latest

# Or Podman
podman pull mindriftfall2infinitepiio/bookmark-manager-mcp:latest

Create .vscode/mcp.json

{
  "servers": {
    "bookmark-manager": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "--interactive",
        "--volume",
        "~/.data:/app/.data",
        "mindriftfall2infinitepiio/bookmark-manager-mcp:latest"
      ]
    }
  }
}

For Podman users:

{
  "servers": {
    "bookmark-manager": {
      "command": "podman",
      "args": [
        "run",
        "--rm",
        "--interactive",
        "--volume",
        "~/.data:/app/.data",
        "mindriftfall2infinitepiio/bookmark-manager-mcp:latest"
      ]
    }
  }
}

Local Development

# Clone the repository
git clone https://github.com/infinitepi-io/bookmark-manager-mcp.git
cd bookmark-manager-mcp

# Install dependencies
pnpm install

# Development mode
pnpm run dev

# Build for production
pnpm run build
pnpm start

🚀 Usage

GitHub Copilot (VS Code)

Agent Mode + Natural Language or # prefix

Add bookmark for GitHub at https://github.com category development

#add bookmark: title "GitHub", url "https://github.com"

#list all my bookmarks in development category

Claude Code (CLI)

Usage: @ prefix

claude @bookmark-manager add bookmark for GitHub at https://github.com

claude @bookmark-manager search development bookmarks

claude @bookmark-manager list all bookmarks

MCP Resources Available

bookmarks://all - All bookmarks
bookmarks://mcp - MCP-related bookmarks
bookmarks://general - General bookmarks
bookmarks://{category} - Custom category bookmarks

Example Usage with Claude

Add a bookmark for "OpenAI Documentation" with URL "https://docs.openai.com" in category "ai"

List all my bookmarks

Show me all MCP-related bookmarks

💾 Data Storage

Storage Location

Local: ~/.data/bookmarks.json
Container (Docker/Podman): /app/.data/bookmarks.json (mount your local ~/.data directory)

Data Format

[
  {
    "title": "Model Context Protocol",
    "url": "https://modelcontextprotocol.io/introduction",
    "category": "mcp"
  },
  {
    "title": "infinitepi-io",
    "url": "https://github.com/infinitepi-io",
    "category": "general"
  }
]

Data Persistence

Automatic Creation: If no bookmarks file exists, default bookmarks are created
Error Handling: Graceful error handling for file operations
Backup Strategy: Simple JSON format allows easy backup and restoration

🐳 Container Configuration

Image Details

Base Image: node:22-alpine
Size: Optimized for minimal footprint
Volumes: /app/.data for persistent storage

📊 Technical Details

Dependencies

@modelcontextprotocol/sdk: ^1.13.2
zod: ^3.25.67 (Schema validation)
Node.js: 22+
TypeScript: 5.0+

Build Process

# TypeScript compilation with esbuild
esbuild index.ts --bundle --platform=node --target=node22 --format=esm --outfile=dist/index.js

Architecture

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   MCP Client    │◄──►│  MCP Server     │◄──►│  JSON Storage   │
│   (Claude)      │    │  (This App)     │    │  (~/.data/)     │
└─────────────────┘    └─────────────────┘    └─────────────────┘

Synching your bookmark to S3 or vice versa BYOS3(Bring your own s3 on aws)

Use below function to copy the data from local to s3 or s3 to local:
- bookmark_sync_to_local_tos3
- bookmark_sync_to_s3_to_local

🤝 Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📝 License

This project is licensed under the Apache License 2.0.

👤 Author

Satish Tripathi

🆘 Support

Issues: GitHub Issues
Documentation: MCP Documentation
Container Registry: mindriftfall2infinitepiio/mcp

Available Tools

2 tools

addAdd BookmarkC

Add a new bookmark

Inputs: title (required), url (required), category.

listList BookmarksB

List all bookmarks

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.1/5.0

Scored 2026-04-14 00:35 across 2 tools

Disambiguation5/5

The two tools have clearly distinct purposes: 'add' is for creating new bookmarks, while 'list' is for retrieving existing ones. There is no overlap or ambiguity between these operations, making it easy for an agent to select the correct tool based on the task.

Naming Consistency5/5

Both tools use simple, imperative verb names ('add' and 'list') that follow a consistent pattern. This naming style is clear and predictable, with no deviations or mixed conventions, ensuring readability and ease of use.

Tool Count2/5

With only two tools, the server feels under-scoped for a bookmark manager, as it lacks essential operations like update, delete, or search. While the count is minimal, it does not provide complete coverage for basic CRUD functionality, making it borderline too few for the domain.

Completeness2/5

The toolset is severely incomplete for a bookmark manager, missing key operations such as update, delete, and search. This creates significant gaps that will likely cause agent failures when trying to manage bookmarks fully, as users cannot modify or remove entries.

Maintenance

ActivityInactive

ResponsivenessOutdated data

Resources

Related MCP Connectors

hithereiamaliff-mcp-nextcloud
ai.smithery
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Cloud Storage File Systems Workplace & Productivity
238
https://server.smithery.ai/@hithereiamaliff/mcp-nextcloud/mcp
Save This One
io.github.yemyat
Save, search, read, tag, and organize your bookmarks from AI assistants with OAuth sign-in.
Note Taking Search Workplace & Productivity
1
https://mcp.savethisone.com/mcp
Threadminder
ai.threadminder
Persistent context for Claude. Your AI always knows your projects and next actions across sessions.
Knowledge & Memory Project Management
2
https://mcp.threadminder.ai/mcp
Bookmax
net.bookmax
Official Bookmax MCP server: search and save bookmarks, read notes and docs from AI assistants.
Note Taking Knowledge & Memory Search
1
https://my.bookmax.net/mcp

Related MCP Servers

MCP Memory Server
Knowledge & Memory Developer Tools
ebailey78
A
license
Not graded
quality
D
maintenance
A Model Context Protocol server for Claude Desktop that provides structured memory management across chat sessions, allowing Claude to maintain context and build a knowledge base within project directories.
Updated 2 years ago (2025-03-06 19:01 UTC)
9 npm
7
MIT
Memory MCP Server
Knowledge & Memory File Systems
grizzlypeaksoftware
A
license
B
quality
D
maintenance
A Model Context Protocol server that enables Claude to persistently store, search, and manage text memories with tags in a local JSON file.
Updated 2 years ago (2025-03-16 04:25 UTC)
14
32 npm
MIT
Claude Continuity MCP Server
Knowledge & Memory Developer Tools Code Execution
donthemannn
A
license
Not graded
quality
D
maintenance
A Model Context Protocol server that provides persistent memory and conversation continuity for Claude Desktop and Claude Code, allowing users to save and restore project context when threads hit token limits.
Updated a year ago (2025-08-06 00:32 UTC)
MIT
Chrome Bookmark MCP Server
Search Developer Tools
mamba-mental
A
license
Not graded
quality
D
maintenance
A Model Context Protocol (MCP) server implementation that provides seamless integration between Chrome bookmarks and AI assistants. This server enables AI models to access, search, analyze, and manage Chrome bookmarks through a standardized protocol.
Updated a year ago (2025-07-25 05:27 UTC)
3
MIT