Can I use Readwise as a CLI?

Yes. KosmoKrator exposes a Readwise CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Readwise through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Readwise tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Readwise credentials stored?

Readwise credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Readwise MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Readwise CLI for AI Agents

Use the Readwise CLI from KosmoKrator to call Readwise tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

Readwise CLI Setup

Readwise can be configured headlessly with `kosmokrator integrations:configure readwise`.

Install, configure, and verify

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure readwise --set access_token="$READWISE_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor readwise --json
kosmokrator integrations:status --json

Credentials

Authentication type: API token api_token. Configure credentials once, then reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

Key	Env var	Type	Required	Label
`access_token`	`READWISE_ACCESS_TOKEN`	Secret `secret`	yes	Access Token
`url`	`READWISE_URL`	Text `text`	no	API URL

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

Generic CLI call

kosmo integrations:call readwise.readwise_check_auth '{}' --json

Provider shortcut

kosmo integrations:readwise readwise_check_auth '{}' --json

Discovery

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

Discovery commands

kosmo integrations:docs readwise --json
kosmo integrations:docs readwise.readwise_check_auth --json
kosmo integrations:schema readwise.readwise_check_auth --json
kosmo integrations:search "Readwise" --json
kosmo integrations:list --json

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CI Run integration calls from CI jobs with JSON output, explicit credentials, and predictable exit status. Cron Jobs Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config. Shell Scripts Call integration functions from shell scripts with stable JSON input and output. Headless Automation Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers. Coding Agents Let coding agents discover schemas and execute integration functions through CLI commands or MCP.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

`readwise.readwise_check_auth`

Validate the Readwise access token.

Read read

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_check_auth '{}' --json

Shortcut

kosmo integrations:readwise readwise_check_auth '{}' --json

`readwise.readwise_list_books`

List Readwise books.

Read read

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_list_books '{}' --json

Shortcut

kosmo integrations:readwise readwise_list_books '{}' --json

`readwise.readwise_get_book`

Get one Readwise book.

Read read

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_get_book '{}' --json

Shortcut

kosmo integrations:readwise readwise_get_book '{}' --json

`readwise.readwise_list_book_tags`

List tags for a Readwise book.

Read read

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_list_book_tags '{}' --json

Shortcut

kosmo integrations:readwise readwise_list_book_tags '{}' --json

`readwise.readwise_create_book_tag`

Create a tag on a Readwise book.

Write write

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_create_book_tag '{}' --json

Shortcut

kosmo integrations:readwise readwise_create_book_tag '{}' --json

`readwise.readwise_delete_book_tag`

Delete a tag from a Readwise book.

Write write

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_delete_book_tag '{}' --json

Shortcut

kosmo integrations:readwise readwise_delete_book_tag '{}' --json

`readwise.readwise_list_highlights`

List Readwise highlights.

Read read

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_list_highlights '{}' --json

Shortcut

kosmo integrations:readwise readwise_list_highlights '{}' --json

`readwise.readwise_create_highlights`

Create one or more Readwise highlights.

Write write

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_create_highlights '{}' --json

Shortcut

kosmo integrations:readwise readwise_create_highlights '{}' --json

`readwise.readwise_get_highlight`

Get one Readwise highlight.

Read read

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_get_highlight '{}' --json

Shortcut

kosmo integrations:readwise readwise_get_highlight '{}' --json

`readwise.readwise_update_highlight`

Update a Readwise highlight.

Write write

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_update_highlight '{}' --json

Shortcut

kosmo integrations:readwise readwise_update_highlight '{}' --json

`readwise.readwise_delete_highlight`

Delete a Readwise highlight.

Write write

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_delete_highlight '{}' --json

Shortcut

kosmo integrations:readwise readwise_delete_highlight '{}' --json

`readwise.readwise_list_highlight_tags`

List tags for a highlight.

Read read

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_list_highlight_tags '{}' --json

Shortcut

kosmo integrations:readwise readwise_list_highlight_tags '{}' --json

`readwise.readwise_create_highlight_tag`

Create a tag on a highlight.

Write write

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_create_highlight_tag '{}' --json

Shortcut

kosmo integrations:readwise readwise_create_highlight_tag '{}' --json

`readwise.readwise_delete_highlight_tag`

Delete a tag from a highlight.

Write write

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_delete_highlight_tag '{}' --json

Shortcut

kosmo integrations:readwise readwise_delete_highlight_tag '{}' --json

`readwise.readwise_export_highlights`

Sync Readwise export data.

Read read

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_export_highlights '{}' --json

Shortcut

kosmo integrations:readwise readwise_export_highlights '{}' --json

`readwise.readwise_get_review_queue`

Get daily review queue items.

Read read

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_get_review_queue '{}' --json

Shortcut

kosmo integrations:readwise readwise_get_review_queue '{}' --json

`readwise.readwise_list_documents`

List Reader documents.

Read read

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_list_documents '{}' --json

Shortcut

kosmo integrations:readwise readwise_list_documents '{}' --json

`readwise.readwise_save_document`

Save a document to Reader.

Write write

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_save_document '{}' --json

Shortcut

kosmo integrations:readwise readwise_save_document '{}' --json

`readwise.readwise_update_document`

Update a Reader document.

Write write

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_update_document '{}' --json

Shortcut

kosmo integrations:readwise readwise_update_document '{}' --json

`readwise.readwise_bulk_update_documents`

Bulk update Reader documents.

Write write

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_bulk_update_documents '{}' --json

Shortcut

kosmo integrations:readwise readwise_bulk_update_documents '{}' --json

`readwise.readwise_delete_document`

Delete a Reader document.

Write write

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_delete_document '{}' --json

Shortcut

kosmo integrations:readwise readwise_delete_document '{}' --json

`readwise.readwise_list_reader_tags`

List Reader tags.

Read read

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_list_reader_tags '{}' --json

Shortcut

kosmo integrations:readwise readwise_list_reader_tags '{}' --json

`readwise.readwise_api_get`

Call a safe relative Readwise GET path.

Read read

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_api_get '{}' --json

Shortcut

kosmo integrations:readwise readwise_api_get '{}' --json

`readwise.readwise_api_post`

Call a safe relative Readwise POST path.

Write write

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_api_post '{}' --json

Shortcut

kosmo integrations:readwise readwise_api_post '{}' --json

`readwise.readwise_api_patch`

Call a safe relative Readwise PATCH path.

Write write

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_api_patch '{}' --json

Shortcut

kosmo integrations:readwise readwise_api_patch '{}' --json

`readwise.readwise_api_delete`

Call a safe relative Readwise DELETE path.

Write write

Parameters: none

Generic call

kosmo integrations:call readwise.readwise_api_delete '{}' --json

Shortcut

kosmo integrations:readwise readwise_api_delete '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

readwise.readwise_check_auth 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_check_auth --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_list_books 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_list_books --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_get_book 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_get_book --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_list_book_tags 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_list_book_tags --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_create_book_tag 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_create_book_tag --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_delete_book_tag 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_delete_book_tag --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_list_highlights 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_list_highlights --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_create_highlights 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_create_highlights --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_get_highlight 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_get_highlight --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_update_highlight 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_update_highlight --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_delete_highlight 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_delete_highlight --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_list_highlight_tags 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_list_highlight_tags --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_create_highlight_tag 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_create_highlight_tag --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_delete_highlight_tag 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_delete_highlight_tag --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_export_highlights 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_export_highlights --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_get_review_queue 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_get_review_queue --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_list_documents 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_list_documents --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_save_document 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_save_document --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_update_document 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_update_document --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_bulk_update_documents 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_bulk_update_documents --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_delete_document 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_delete_document --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_list_reader_tags 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_list_reader_tags --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_api_get 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_api_get --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_api_post 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_api_post --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_api_patch 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_api_patch --json

Parameter	Type	Required	Description
No parameters.

readwise.readwise_api_delete 0 parameters

Schema command

kosmo integrations:schema readwise.readwise_api_delete --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.