@keeply-link/mcp

MCP server for Keeply — manage your bookmarks from any AI assistant.

What it does

Connects your Keeply bookmark library to MCP-compatible AI assistants (Claude, Cursor, Windsurf, and others). Search, save, and organise bookmarks without leaving your conversation.

Installation

Claude Code

claude mcp add keeply -e KEEPLY_API_KEY="your-api-key" -- npx -y @keeply-link/mcp

Claude Desktop / Cursor / Windsurf

Add to your MCP config:

{
  "mcpServers": {
    "keeply": {
      "command": "npx",
      "args": ["-y", "@keeply-link/mcp"],
      "env": {
        "KEEPLY_API_KEY": "your-api-key"
      }
    }
  }
}

OpenCode

Add to your opencode.json:

{
  "mcp": {
    "keeply": {
      "type": "local",
      "command": ["npx", "-y", "@keeply-link/mcp"],
      "environment": {
        "KEEPLY_API_KEY": "your-api-key"
      }
    }
  }
}

Setup

1. Get an API key at app.keeply.tools under Settings → API Keys
2. Grant the following scopes: read_bookmarks, create_bookmark, update_bookmark, delete_bookmark, read_folders, read_tags, search_bookmarks
3. Add the server to your AI client using the config above

Available tools

| Tool | Description | | ------------------ | ---------------------------------------------------------------------- | | search_bookmarks | Search across your library | | list_bookmarks | List bookmarks, optionally filtered by folder, tag, or archived status | | get_bookmark | Fetch a single bookmark by ID | | add_bookmark | Save a new bookmark | | update_bookmark | Update title, note, tags, folder, or archived status | | delete_bookmark | Soft-delete a bookmark (recoverable from the app) | | list_folders | List all folders with bookmark counts | | list_tags | List all tags with bookmark counts |

Environment variables

| Variable | Required | Description | | ---------------- | -------- | ------------------- | | KEEPLY_API_KEY | Yes | Your Keeply API key |

Documentation

Full documentation at dev.keeply.tools/docs/mcp.

License

MIT