readeck

// Readeck integration for saving and managing articles. Supports adding URLs, listing entries, and managing bookmarks via Readeck's API. Configure custom URL and API key per request or via environment variables READECK_URL and READECK_API_KEY.

$ git log --oneline --stat

stars:1,933

forks:367

updated:March 4, 2026

SKILL.mdreadonly

SKILL.md Frontmatter

namereadeck

descriptionReadeck integration for saving and managing articles. Supports adding URLs, listing entries, and managing bookmarks via Readeck's API. Configure custom URL and API key per request or via environment variables READECK_URL and READECK_API_KEY.

Readeck Integration

Configuration

Configure Readeck access via:

Request parameters: url and apiKey
Environment variables: READECK_URL and READECK_API_KEY

Core Operations

Add Article

Add a URL to Readeck for parsing and saving:

curl -X POST "$READECK_URL/api/bookmarks" \
  -H "Authorization: Bearer $READECK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/article"}'

Response includes id, url, and title.

List Entries

Fetch saved articles:

curl "$READECK_URL/api/bookmarks?limit=20" \
  -H "Authorization: Bearer $READECK_API_KEY"

Query parameters: page, limit, status, search.

Get Single Entry

curl "$READECK_URL/api/bookmarks/$ID" \
  -H "Authorization: Bearer $READECK_API_KEY"

Delete Entry

curl -X DELETE "$READECK_URL/api/bookmarks/$ID" \
  -H "Authorization: Bearer $READECK_API_KEY"

Mark as Read

curl -X PUT "$READECK_URL/api/bookmarks/$ID/status" \
  -H "Authorization: Bearer $READECK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "read"}'

Common Patterns

Save with tags:

{"url": "https://example.com", "tags": ["tech", "readlater"]}

Save to specific collection:

{"url": "https://example.com", "collection": "my-collection"}

Filter by status: unread, read, archived

Error Handling

401: Invalid API key
404: Entry not found
422: Invalid URL or request body