# Raindrop.io for AI agents. Make saved research easy to use.

> Find collections and bookmarks in a user’s Raindrop.io library. Prepare research briefs grounded in saved links and their returned metadata.

- Page: https://www.agent200.com/connectors/raindrop-io/
- Category: Files and knowledge
- Authentication: Managed OAuth
- Identifier in code: `raindrop_io`
- Create an API key: https://agent200.com/platform/apikeys/
- Updated: 2026-11-18

## Instructions for AI agents

Connector: Raindrop.io, through Agent200. In code: "raindrop_io".
What it does: Find collections and bookmarks in a user’s Raindrop.io library. Prepare research briefs grounded in saved links and their returned metadata.
Page: https://www.agent200.com/connectors/raindrop-io/

1. Get an Agent200 API key. If the developer has none, send them to https://agent200.com/platform/apikeys/ and ask them to choose "Create an API key". Read the key from the AGENT200_API_KEY environment variable. Never ask for it in chat, and never write it into code, prompts or logs.
2. Sign-in is managed OAuth. Each end user approves access once, on Raindrop.io's own page, through the authorization link Agent200 returns. Never ask a user for a Raindrop.io password or token in chat.
3. Give every request a stable id for the end user. Agent200 uses only that user's own connection.
4. Read tools: raindrop_io_list_collections, raindrop_io_list_child_collections, raindrop_io_get_collection, raindrop_io_list_bookmarks, raindrop_io_search_bookmarks, raindrop_io_get_bookmark. Name "raindrop_io" in the tools of a request; the model decides which tool to call.
5. Stay within the project's settings. If a tool is turned off or a call is refused, tell the user. Do not work around it.
6. Before a write, confirm with the user, unless they asked for that exact change.
7. For setup with a specific framework, follow its guide:
   https://www.agent200.com/connectors/raindrop-io/framework/claude/
   https://www.agent200.com/connectors/raindrop-io/framework/chatgpt/
   https://www.agent200.com/connectors/raindrop-io/framework/claude-code/
   https://www.agent200.com/connectors/raindrop-io/framework/muse/
   https://www.agent200.com/connectors/raindrop-io/framework/grok-bot/
   https://www.agent200.com/connectors/raindrop-io/framework/openai-dots/
   https://www.agent200.com/connectors/raindrop-io/framework/claude-duet/
   https://www.agent200.com/connectors/raindrop-io/framework/hermes-agent/
   https://www.agent200.com/connectors/raindrop-io/framework/openclaw/

The code on the connector page is a conceptual example of the SDK. SDK reference: https://docs.igpt.ai/

## About

With the Raindrop.io connector, your agent reads bookmarks in each user's own Raindrop.io library. It can list collections, search bookmarks, and read the details of a saved link, using only the tools your project allows.

Raindrop.io is a bookmark manager for saving and organizing links.

## Raindrop.io tools

- **List root collections** (`raindrop_io_list_collections`, read): Find the connected user’s top-level collections.
- **List child collections** (`raindrop_io_list_child_collections`, read): Find child collections under accessible collection folders.
- **Read a collection** (`raindrop_io_get_collection`, read): Retrieve one identified collection and its returned metadata.
- **List bookmarks** (`raindrop_io_list_bookmarks`, read): Read saved links in one collection with the requested result scope.
- **Search bookmarks** (`raindrop_io_search_bookmarks`, read): Search saved links in the connected user’s library.
- **Read a bookmark** (`raindrop_io_get_bookmark`, read): Retrieve one identified saved link and its returned metadata.

## Limits you can set

**Turn single tools on or off.** Let the agent browse collections and bookmarks, and switch off `raindrop_io_search_bookmarks` if it should only list them.

**Restrict what the agent reaches.** Choose the endpoints and scopes a project may use, for example collections but not individual bookmarks. A call outside them is refused.

## Get started

### Step 1: Set up the SDK

Add the Agent200 SDK to the codebase you already have and authenticate with your API key. The key covers every connector enabled for the project.

File `agent.js`:

```js
// One Agent200 API key covers every connector enabled for the project.
const agent200 = new Agent200({
  apiKey: process.env.AGENT200_API_KEY,
});
```

(Conceptual example of the Agent200 SDK.)

### Step 2: Let your user connect Raindrop.io

Each end user authorizes their own Raindrop.io account once. Agent200 runs the OAuth flow, handles the callback, stores the tokens and refreshes them.

File `connect.js`:

```js
// Each end user authorizes their own Raindrop.io account, once.
const connection = await agent200
  .user("user_123")
  .connect("raindrop_io");

if (connection.authorizationUrl) {
  // Show this link to your user; Agent200 handles the rest.
  console.log(connection.authorizationUrl);
}
```

(Conceptual example of the Agent200 SDK.)

### Step 3: Run with the Raindrop.io tools

Name the user, the model and the tools. The model decides which Raindrop.io tools to call, and Agent200 executes them with that user's connection.

File `run.js`:

```js
const result = await agent200
  .user("user_123")
  .run({
    model: "openai/gpt-5.6-sol",
    input: "Find my saved links about vector databases",
    tools: ["raindrop_io"],
  });

console.log(result.output);
```

(Conceptual example of the Agent200 SDK.)

## Sign-in and permissions

**Connect the intended Raindrop.io account.** Have the end user authorize the registered Agent200 application through Raindrop.io OAuth. Select the user’s intended library and collection before reading saved links.

**Respect the connected user’s library.** Collection and bookmark results come from the authorized account. Resolve a collection ID when names are similar and follow pagination for larger reading lists.

**Keep the application user stable.** Use the same authenticated application user for authorization and later requests. Keep the Agent200 key in secure server configuration.

## Example requests

- "Find my saved links about vector databases"
- "List the collections in my Raindrop.io library"
- "Show the bookmarks I saved in the Research collection"

## Guides: Raindrop.io with your AI framework

- [Raindrop.io + Claude](https://www.agent200.com/connectors/raindrop-io/framework/claude.md): Read bookmarks with Claude and Agent200. Prepare a research brief using the connected user’s own Raindrop.io account.
- [Raindrop.io + ChatGPT](https://www.agent200.com/connectors/raindrop-io/framework/chatgpt.md): Use ChatGPT to build a separate read-only Raindrop.io assistant with Agent200. Ground the research brief in returned source data.
- [Raindrop.io + Claude Code](https://www.agent200.com/connectors/raindrop-io/framework/claude-code.md): Use Claude Code to build a separate read-only Raindrop.io assistant with Agent200. Ground the research brief in returned source data.
- [Raindrop.io + Muse](https://www.agent200.com/connectors/raindrop-io/framework/muse.md): Read bookmarks with Muse and Agent200. Prepare a research brief using the connected user’s own Raindrop.io account.
- [Raindrop.io + Grok Bot](https://www.agent200.com/connectors/raindrop-io/framework/grok-bot.md): Read bookmarks with Grok Bot and Agent200. Prepare a research brief using the connected user’s own Raindrop.io account.
- [Raindrop.io + OpenAI Dots](https://www.agent200.com/connectors/raindrop-io/framework/openai-dots.md): Use OpenAI Dots to build a separate read-only Raindrop.io assistant with Agent200. Ground the research brief in returned source data.
- [Raindrop.io + Claude Duet](https://www.agent200.com/connectors/raindrop-io/framework/claude-duet.md): Read bookmarks with Claude Duet and Agent200. Prepare a research brief using the connected user’s own Raindrop.io account.
- [Raindrop.io + Hermes Agent](https://www.agent200.com/connectors/raindrop-io/framework/hermes-agent.md): Read bookmarks with Hermes Agent and Agent200. Prepare a research brief using the connected user’s own Raindrop.io account.
- [Raindrop.io + OpenClaw](https://www.agent200.com/connectors/raindrop-io/framework/openclaw.md): Read bookmarks with OpenClaw and Agent200. Prepare a research brief using the connected user’s own Raindrop.io account.

## FAQ

### What does a bookmark result contain?

The API returns saved-link fields such as title, link, description, tags and collection identifiers when available. A bookmark record is not proof that the linked article’s full text was read. [Raindrop.io bookmark reference](https://developer.raindrop.io/v1/raindrops/single).

### How do I find bookmarks in nested collections?

Raindrop.io separates top-level and child collection endpoints. Fetch both when the requested folder may be nested, then use the returned collection ID. [Nested collections reference](https://developer.raindrop.io/v1/collections/nested-structure).

### Does a search return the whole library?

No. Search and list responses can be paginated. State the query, collection and result scope used; do not infer that absent results mean no saved bookmark exists.

### Can the agent save or edit bookmarks?

The listed tools are read operations. A suggested reading list in an answer does not add, edit or delete saved links.

### How is access granted?

Raindrop.io documents OAuth authorization for registered applications. The end user authorizes the account used for the read; inspect the runtime’s advertised schemas before calling any tool. [OAuth reference](https://developer.raindrop.io/v1/authentication/token).

## Related connectors

- [Google Drive](https://www.agent200.com/connectors/google-drive.md): Find, read and organize the files in each user's Drive.
- [OneDrive](https://www.agent200.com/connectors/onedrive.md): Search, read, upload and share OneDrive files, including Word, Excel and PowerPoint documents, on behalf of each of your users.
- [Dropbox](https://www.agent200.com/connectors/dropbox.md): Search, read, upload and organize Dropbox files, and create shared links, on behalf of each of your users.
- [Notion](https://www.agent200.com/connectors/notion.md): Search, read and write Notion pages and databases on behalf of each of your users.

---

Agent200: https://www.agent200.com/ · API keys: https://agent200.com/platform/apikeys/ · Docs: https://docs.igpt.ai/
