Claude AI Setup (MCP)

Manage your LinkaGoGo bookmarks by chatting with Claude.

The LinkaGoGo MCP server connects Claude Desktop to your bookmark collection using the Model Context Protocol. Search, add, organize, tag, and export bookmarks conversationally — no need to open the web UI.

Requires a Plus or Premium subscription.

Get Your API Key

Log in to LinkaGoGo
Click your avatar in the top-right corner and select Account
Scroll to API Keys and enter a name (e.g. "Claude Desktop")
Click Generate Key and copy the key — it starts with lgg_ and won't be shown again

Install Node.js

The MCP server requires Node.js version 18 or later. Download and install it if you don't have it already.

Verify with:

node --version

Configure Claude Desktop

Open your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

If the file doesn't exist, create it. Add the LinkaGoGo server:

{
  "mcpServers": {
    "linkagogo": {
      "command": "npx",
      "args": ["-y", "linkagogo-mcp"],
      "env": {
        "LINKAGOGO_API_TOKEN": "lgg_your_api_key_here"
      }
    }
  }
}

Replace lgg_your_api_key_here with your API key from Step 1.

That's it — no download or build step needed. Claude Desktop will install the MCP server automatically via npx.

Restart Claude Desktop

Quit Claude Desktop completely (Cmd+Q on macOS, not just close the window), then reopen it.

You should see the hammer icon in the chat input area. Click it to verify LinkaGoGo's tools are listed.

Start Chatting

Ask Claude naturally:

"How many bookmarks do I have?"
"Search my bookmarks for Python tutorials"
"Add https://example.com to my Dev folder with tags 'reference' and 'docs'"
"What are my most visited bookmarks?"
"Show me my folder tree"
"Move all bookmarks tagged 'old' into an Archive folder"
"Export my Recipes folder as XBEL"
"What reminders are due?"

Available Tools

Tool	What It Does
`search_bookmarks`	Search by keyword, filter by folder, sort by date/visits/rating
`add_bookmark`	Save a new bookmark (auto-fetches title if omitted)
`update_bookmark`	Update title, URL, keywords, rating, favorite, reminder
`delete_bookmark`	Delete a bookmark
`move_bookmarks`	Move bookmarks to a folder (bulk)
`tag_bookmarks`	Add or remove keyword tags (bulk)
`list_folders`	Show folder tree or children of a folder
`create_folder`	Create a folder or a nested path (e.g. "Dev/Python/Libs")
`rename_folder`	Rename a folder
`move_folder`	Move a folder to a new parent
`delete_folder`	Delete a folder and its contents
`export_bookmarks`	Export as XBEL or Netscape HTML (full or by folder)
`import_bookmarks`	Import from XBEL or Netscape HTML
`get_stats`	Account statistics
`get_reminders`	Bookmarks with due reminders

Troubleshooting

"LINKAGOGO_API_TOKEN environment variable is required" — Your API key is missing from the Claude Desktop config file.
Tools not showing up — Make sure you quit and reopened Claude Desktop (Cmd+Q). Check that node is in your PATH and the path to dist/index.js is correct.
"Invalid API key" — Your key may have been revoked or mistyped. Generate a new one in Account > API Keys.
"Rate limit exceeded" — Plus allows 5,000 requests/day per key; Premium allows 10,000/day. Wait until the next day or generate an additional key.

Updating

The MCP server updates automatically — npx fetches the latest version each time Claude Desktop starts. To force an update immediately:

npx -y linkagogo-mcp@latest --help

Then restart Claude Desktop.