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 MCP, CLI, and Lua Integration for AI Agents

Readwise integration docs for AI agents: MCP gateway setup, Readwise CLI commands, Lua API reference, credentials, and function schemas.

Readwise for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Agent Surfaces

Readwise CLIHeadless setup, JSON output, direct function calls. Readwise MCPExpose selected tools to local MCP clients. Readwise LuaAgent-facing namespace and Lua reference. FeedbackReport missing tools, auth issues, or bad metadata.

Machine-Readable Metadata

integration_slug: readwise
route_slug: readwise
package: readwise
auth_strategy: api_token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true

Function Catalog

Function	Type	Description
`readwise.readwise_check_auth`	Read `read`	Validate the Readwise access token.
`readwise.readwise_list_books`	Read `read`	List Readwise books.
`readwise.readwise_get_book`	Read `read`	Get one Readwise book.
`readwise.readwise_list_book_tags`	Read `read`	List tags for a Readwise book.
`readwise.readwise_create_book_tag`	Write `write`	Create a tag on a Readwise book.
`readwise.readwise_delete_book_tag`	Write `write`	Delete a tag from a Readwise book.
`readwise.readwise_list_highlights`	Read `read`	List Readwise highlights.
`readwise.readwise_create_highlights`	Write `write`	Create one or more Readwise highlights.
`readwise.readwise_get_highlight`	Read `read`	Get one Readwise highlight.
`readwise.readwise_update_highlight`	Write `write`	Update a Readwise highlight.
`readwise.readwise_delete_highlight`	Write `write`	Delete a Readwise highlight.
`readwise.readwise_list_highlight_tags`	Read `read`	List tags for a highlight.
`readwise.readwise_create_highlight_tag`	Write `write`	Create a tag on a highlight.
`readwise.readwise_delete_highlight_tag`	Write `write`	Delete a tag from a highlight.
`readwise.readwise_export_highlights`	Read `read`	Sync Readwise export data.
`readwise.readwise_get_review_queue`	Read `read`	Get daily review queue items.
`readwise.readwise_list_documents`	Read `read`	List Reader documents.
`readwise.readwise_save_document`	Write `write`	Save a document to Reader.
`readwise.readwise_update_document`	Write `write`	Update a Reader document.
`readwise.readwise_bulk_update_documents`	Write `write`	Bulk update Reader documents.
`readwise.readwise_delete_document`	Write `write`	Delete a Reader document.
`readwise.readwise_list_reader_tags`	Read `read`	List Reader tags.
`readwise.readwise_api_get`	Read `read`	Call a safe relative Readwise GET path.
`readwise.readwise_api_post`	Write `write`	Call a safe relative Readwise POST path.
`readwise.readwise_api_patch`	Write `write`	Call a safe relative Readwise PATCH path.
`readwise.readwise_api_delete`	Write `write`	Call a safe relative Readwise DELETE path.