Overview
The Bookmarkjar skill lets you search and save bookmarks directly from Claude Code (CLI or VS Code) using a simple slash command — no MCP configuration needed.
You’ll need an API key. Create one in Dashboard → Profile → API Keys.
Install
Create the skill directory
mkdir -p ~/.claude/skills/bookmarkjar
Create the skill file
Copy the content from the Skill Source section below and save it as:~/.claude/skills/bookmarkjar/SKILL.md
Set your API key
Add to your shell profile (~/.zshrc, ~/.bashrc, etc.):export BOOKMARKJAR_API_KEY="your-api-key-here"
Use it
Open Claude Code and type:/bookmarkjar react hooks state management
/bookmarkjar save https://react.dev/reference/react/useState
What it does
The skill gives Claude Code two capabilities:
| Action | Example |
|---|
| Search bookmarks by keywords, tags, or domain | /bookmarkjar typescript testing patterns |
| Save one or more URLs as bookmarks | /bookmarkjar save https://example.com |
Examples
/bookmarkjar find all React bookmarks tagged with hooks
/bookmarkjar search for database migration guides
/bookmarkjar save https://drizzle.team/docs/orm https://orm.drizzle.team
/bookmarkjar what bookmarks do I have about kubernetes?
Skill Source
If you prefer to create the file manually, save this as ~/.claude/skills/bookmarkjar/SKILL.md:
---
name: bookmarkjar
description: Search and save bookmarks from Bookmarkjar. Use when the user wants to find, search, list, or save bookmarks.
user-invocable: true
allowed-tools: Bash
argument-hint: [search query or "save URL"]
---
# Bookmarkjar Skill
Search or save bookmarks via the Bookmarkjar API.
## How to use
Parse the user's intent from `$ARGUMENTS`:
- If it contains "save" or a raw URL → **insert** the URL(s)
- Otherwise → **search** with the query
## Search
Call the API to search bookmarks:
curl -s -X POST "https://bookmarkjar.com/api/tools/mcp" \
-H "Content-Type: application/json" \
-H "x-api-key: $BOOKMARKJAR_API_KEY" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "bookmarks.search",
"arguments": { "search": "<query>", "limit": 10 }
}
}'
Display results as a readable list with title, URL, tags, and description.
## Insert
Call the API to save bookmarks:
curl -s -X POST "https://bookmarkjar.com/api/tools/mcp" \
-H "Content-Type: application/json" \
-H "x-api-key: $BOOKMARKJAR_API_KEY" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "bookmarks.insert",
"arguments": { "urls": ["<url1>", "<url2>"] }
}
}'
Confirm how many bookmarks were saved.
## Error handling
- If `$BOOKMARKJAR_API_KEY` is not set, tell the user to set it
- If the API returns an error, show the error message
MCP vs Skill
| Feature | MCP Server | Skill |
|---|
| Setup | JSON config + restart | Copy one file |
| Works in | Any MCP client (Claude, Cursor, etc.) | Claude Code only |
| Auth | Handled by client headers | Environment variable |
| Tools | Auto-discovered | Natural language routing |
For the best experience, use both: the MCP server for always-on tool access, and the skill for quick slash-command searches. 
