LinkaGoGo MCP Server

Manage your LinkaGoGo bookmarks with AI assistants using the Model Context Protocol. Search, add, organize, tag, and export bookmarks conversationally — no need to open the web UI.

Works with Claude, ChatGPT, Cursor, VS Code + Copilot, and any MCP-compatible client.

What You Need

1. A LinkaGoGo account with a Plus or Premium subscription — sign up
2. An API key — generate one in your LinkaGoGo account under Account > API Keys
3. Node.js 18 or later — download
4. An MCP-compatible AI client (see setup options below)

Step 1: Get Your API Key

1. Log in to LinkaGoGo
2. Click your avatar in the top-right corner and select Account
3. Scroll down to the API Keys section
4. Enter a name (e.g. "Claude") and click Generate Key
5. Copy the key immediately — it starts with lgg_ and won't be shown again

Step 2: Connect Your AI Client

Claude.ai (Web) — One-Click

1. Go to claude.ai and open Settings
2. Select Integrations and click Add More
3. Search for LinkaGoGo and click Connect
4. Authorize with your LinkaGoGo credentials — done!

No API key or local installation needed.

Claude Desktop

Open the 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 MCP server:

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

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.

ChatGPT

ChatGPT supports MCP connectors. Connect the same way as Claude.ai:

1. Open Settings > Integrations > Add More
2. Search for LinkaGoGo and click Connect
3. Authorize with your LinkaGoGo credentials

Cursor

1. Open Cursor and go to Settings > MCP
2. Click Add new MCP server
3. Set the command to npx -y linkagogo-mcp and add the environment variable LINKAGOGO_API_TOKEN with your API key
4. Save and restart Cursor

VS Code + GitHub Copilot

Add to your VS Code settings (settings.json):

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

Other Clients

Any MCP-compatible client can connect using:

LINKAGOGO_API_TOKEN=lgg_your_key npx linkagogo-mcp

For SSE transport (remote/web clients), see the full setup guide.

Try It Out

Ask your AI assistant naturally:

• "How many bookmarks do I have?"
• "Search my bookmarks for Python tutorials"
• "Find bookmarks tagged python with 3+ stars" (advanced search)
• "Show me bookmarks I haven't visited in 30 days" (advanced search)
• "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"
• "Make my Recipes folder public"
• "Delete all bookmarks tagged 'temp'"
• "Rate my Python bookmarks 5 stars"
• "Favorite all bookmarks in my Recipes folder"
• "Set a weekly Monday reminder on these bookmarks"
• "Unfavorite bookmarks I haven't visited in a year"
• "Do I have any dead links?"
• "What reminders are due?"

Advanced Search

The search_bookmarks tool supports prefix operators for fine-grained filtering:

| Operator | Example | Meaning | |----------|---------|---------| | tag: | tag:python | Keywords contain "python" | | -tag: | -tag:misc | Exclude tag | | url: | url:github.com | URL contains pattern | | star: | star:3+ | Rating 3 or above | | fav: | fav:yes | Favorites only | | visits: | visits:10+ | Visited 10+ times | | visited: | visited:7d / visited:never | Visited within 7 days, or never | | created: | created:30d+ | Created more than 30 days ago | | modified: | modified:7d | Modified within 7 days | | OR | tag:python OR tag:javascript | Either tag matches |

Combine freely: tag:python tutorial star:3+ — tagged "python", containing "tutorial", rated 3+.

Plain text queries still work as before (searches title, URL, keywords, comments).

Available Tools

| Tool | What It Does | |------|-------------| | search_bookmarks | Search with prefix operators, 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) | | delete_bookmarks | Delete multiple bookmarks (bulk) | | rate_bookmarks | Set star rating 0–5 on bookmarks (bulk) | | favorite_bookmarks | Set or unset favorite on bookmarks (bulk) | | set_reminder | Set reminder schedule on bookmarks (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 | | update_folder | Update a folder's name, public visibility, or description | | 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_dead_links | Find dead, redirected, and uncertain links | | get_reminders | Bookmarks with due reminders |

Troubleshooting

"LINKAGOGO_API_TOKEN environment variable is required" Your API key is missing from the client config. Check your configuration file.

Tools not showing up Make sure you fully restarted your AI client. Check that node is in your PATH.

"Invalid API key" errors Your API key may have been revoked or mistyped. Generate a new one in Account > API Keys.

"Rate limit exceeded" The API allows 5,000 requests/day on Plus and 10,000/day on Premium per API key. Wait until the next day or generate an additional key.

Updating

The MCP server updates automatically — npx fetches the latest version each time your AI client starts.

Development

To run without building (uses tsx):

LINKAGOGO_API_TOKEN=lgg_your_key npm run dev

To test with the MCP Inspector:

LINKAGOGO_API_TOKEN=lgg_your_key LINKAGOGO_API_URL=http://localhost:8000 npx @modelcontextprotocol/inspector node dist/index.js