Connect with an access token

To call Clone+ from your own script or the command line, issue an access token and send it in the Authorization header.

Step 1: Issue a token

1. Open Clone+ and go to Settings, then Connectors.
2. Issue an access token. You choose whether it is read-only or may also write.
3. Copy the token that appears (it starts with clp_). It is never shown again once you close that screen.

Step 2: List the available tools

This is the quickest way to confirm the connection. There is no session to open first.

export CLONE_TOKEN="clp_..."

curl -s https://mcp.clone-plus.com/mcp \
  -H "Authorization: Bearer $CLONE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

A read-only token does not see the write tools in this list at all.

Step 3: Search your notes

Call clone_search_memos. It does a case-insensitive substring match on title and body, newest first.

curl -s https://mcp.clone-plus.com/mcp \
  -H "Authorization: Bearer $CLONE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "jsonrpc": "2.0",
        "id": 2,
        "method": "tools/call",
        "params": {
          "name": "clone_search_memos",
          "arguments": { "query": "zettelkasten", "limit": 5 }
        }
      }'

On success the tool output comes back in result. Trashed, fleeting, and deleted notes are excluded.

When you get an error

Revoke a token

You can revoke an issued token from Settings, then Connectors. It stops working immediately. If a token may have leaked, revoke it right away and issue a new one.