geekmonks-mcp-bookmarks
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@geekmonks-mcp-bookmarks search my bookmarks for TypeScript"
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.
geekmonks-mcp-bookmarks
Companion lab for the GeekMonks MCP series: a local bookmarks MCP server over stdio (TypeScript).
Series hub: MCP Without the Hype
Checkpoint tags:
part-3(tools only),part-4(tools + resourcebookmarks://list+ promptsummarize-bookmarks)
Host note: tools show up most reliably in Cursor. Verify resources and prompts with MCP Inspector even when the host UI is limited.
Requirements
Node.js 20+
Related MCP server: bookmarks-mcp
Setup
git clone https://github.com/SRVivek1/geekmonks-mcp-bookmarks.git
cd geekmonks-mcp-bookmarks
git checkout part-3 # or part-4
npm install
npm run buildOptional: set BOOKMARKS_PATH to a JSON file path. Default store: ./data/bookmarks.json (created on first use; gitignored).
MCP Inspector (prove tools without Cursor)
From the repo root after npm run build:
npx @modelcontextprotocol/inspector node dist/index.jsConnect, open Tools, try list_bookmarks / add_bookmark / search_bookmarks.
On tag part-4, also check Resources (bookmarks://list) and Prompts (summarize-bookmarks).
Cursor (mcp.json)
Project config example (adjust the absolute path):
{
"mcpServers": {
"bookmarks": {
"type": "stdio",
"command": "node",
"args": ["/ABS/PATH/TO/geekmonks-mcp-bookmarks/dist/index.js"]
}
}
}Reload MCP / start a new Agent chat. Approve tool calls when prompted.
Logging rule
Never write protocol noise to stdout. This server logs only with console.error (stderr).
License
MIT
Available Tools
3 toolsadd_bookmarkAdd bookmarkA
Add a bookmark with a title and URL to the local JSON store.
Inputs: url (required), title (required).
list_bookmarksList bookmarksA
List all saved bookmarks from the local JSON store.
Inputs: no named parameters.
search_bookmarksSearch bookmarksA
Search bookmarks by substring match on title or URL.
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a distinct purpose: listing, adding, and searching bookmarks. There is no overlap or ambiguity between them.
All tool names follow a consistent verb_noun pattern: list_bookmarks, add_bookmark, search_bookmarks. The pattern is clear and predictable.
With only 3 tools, the server is minimal but covers the basic operations for a bookmark store. It feels slightly thin but is reasonable for a simple local JSON store.
The server provides list, add, and search, but lacks update and delete operations, which are common for bookmark management. This is a notable gap but agents can work around it by not needing those operations.
Maintenance
Related MCP Connectors
Personal knowledge MCP: capture bookmarks, notes & todos by chat; archive pages; search memory.
Search, label, and manage your X (Twitter) bookmarks from any MCP client via Tweetsmash
Official Bookmax MCP server: search and save bookmarks, read notes and docs from AI assistants.
Search and chat with your X bookmarks, with citations back to the original posts.
Related MCP Servers
- AlicenseAqualityFmaintenanceA bookmark management MCP server that enables saving, searching, and managing bookmarks with tags and read/unread status, providing tools, resources, and prompts for integration.4MIT
- FlicenseAqualityCmaintenanceEnables AI assistants to search, browse, add, and delete Chrome and Edge bookmarks through the MCP protocol, using a local FastMCP server that directly reads and modifies browser bookmark files.5-
- AlicenseNot gradedqualityDmaintenanceProvides authenticated bookmark management tools via MCP, including adding, deleting, listing, and searching bookmarks.2,274 npmMIT
- AlicenseAqualityBmaintenanceEnables reading and writing Chrome bookmarks (folders, URLs, search, move, remove) through MCP clients like Claude Code, using a companion Chrome extension for secure local communication.1118 npm1MIT