Pinboard

Pinboard bookmarks MCP server

python

5

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "rossshannon-pinboard-bookmarks-mcp-server": {
      "command": "pinboard-mcp-server",
      "args": [],
      "env": {
        "PINBOARD_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Pinboard MCP Server gives read-only access to Pinboard.in bookmarks for large language models through the MCP framework. It provides search, listing, and tagging tools with smart caching and rate-limited API usage to keep up with Pinboard’s guidelines, making it practical to incorporate bookmark data into inference workflows.

How to use

You run the Pinboard MCP Server locally or in your environment and connect your MCP client to it. The server exposes four tools that you can invoke from your MCP client to interact with Pinboard bookmarks: searchBookmarks, listRecentBookmarks, listBookmarksByTags, and listTags. The server caches results to improve latency and respects Pinboard’s API rate limits by enforcing a 3-second delay between calls. Use the tools to fetch bookmark metadata, search by keywords, filter by tags and dates, or discover popular tags.

How to install

pip install pinboard-mcp-server

From source (optional development workflow)

git clone https://github.com/rossshannon/pinboard-bookmarks-mcp-server.git cd pinboard-bookmarks-mcp-server pip install -e .

Prerequisites you need installed on your system:

Python (3.x) and pip
A Pinboard API token (see next section for how to set it)

After installation, you start the MCP server with the CLI command described below.

## Configuration and startup

Set your Pinboard API token as an environment variable before starting the server.

export PINBOARD_TOKEN="username:token_here"

pinboard-mcp-server

## Connecting from an MCP client (example config)

{ "mcpServers": { "pinboard": { "command": "pinboard-mcp-server", "env": { "PINBOARD_TOKEN": "your-username:your-token-here" } } } }


## Available tools

### searchBookmarks

Search bookmarks by a query string, scanning titles, notes, and tags to return matching items.

### listRecentBookmarks

List bookmarks saved in the last N days, with optional limit to control results.

### listBookmarksByTags

List bookmarks filtered by one or more tags, with optional date range and limit.

### listTags

List all tags with their usage counts to understand tag distribution.