refineo-cli is a command-line tool to humanize AI-generated text directly in your terminal. Available as an npm package for Node.js environments and pip for Python environments. The CLI serves two main purposes: standalone usage from the command line for quick transformations, and MCP server functionality for integrations with AI coding assistants like Claude Code, Cursor, or any MCP-compatible tools.
Transform robotic AI-generated content into human-sounding text. Great for writing blog posts, documentation, emails, or any other content you don't want to sound like a robot.
Installation
Choose your preferred package manager:
Node.js / npm
npm install -g refineo-cli
Python / pip
pip install refineo-cli
Both packages provide identical functionality. Pick whichever fits your environment.
Why Use the CLI?
You might be wondering why you would want to use a CLI tool instead of a web app for humanizing your text. There are a few good reasons:
- Automation pipelines — Developers can integrate it into workflows and automation. Build scripts, CI/CD automation, or content generation systems could all use an automated humanization step.
- Stay in your editor — If you use AI coding assistants like Claude Code or Cursor, the MCP integration means you can humanize text without leaving your editor. Just ask your AI assistant to humanize the text, and it handles the request through the Refineo MCP server.
- Batch processing — You have many files or documents to humanize? The CLI is perfect for this. A simple shell script and refineo-cli gets the job done.
MCP Integration
The CLI includes a built-in MCP (Model Context Protocol) server. This lets AI assistants call Refineo directly.
Supported Tools
| Tool | Setup Method |
|---|---|
| Claude Desktop | Native connector or config file |
| Claude Code | claude mcp add command |
| Cursor | MCP config in settings |
| Other MCP clients | Standard MCP configuration |
For detailed Claude Desktop and Claude Cowork setup instructions, see our guide on how to use Refineo with Claude Desktop.
Claude Code Quick Setup
Add Refineo to Claude Code with one command:
claude mcp add-json refineo '{"type":"http","url":"https://www.refineo.app/mcp/mcp","headers":{"X-API-Key":"YOUR_API_KEY"}}'
Replace YOUR_API_KEY with your actual API key from the dashboard.
Available Commands
Once installed, you get access to these commands:
Humanize Text
refineo-cli humanize "Your AI-generated text here"
Or pipe content:
echo "Your text" | refineo-cli humanize
Check Usage
refineo-cli usage
Shows your remaining quota for the current billing period.
Authentication
refineo-cli auth
Set up or update your API key.
Getting Started
Getting started with refineo-cli is pretty simple:
- Get a Refineo account — You'll need a Pro or Ultra subscription since MCP integration is a premium feature. Sign up here.
- Generate an API key — Head to your dashboard and create a new API key.
- Install the CLI — Run
npm install -g refineo-cliorpip install refineo-cli. - Authenticate — Run
refineo-cli authand enter your API key. - Start humanizing — Use the CLI directly or configure MCP with your AI assistant.
Package Links
Questions?
Check out our complete guide to humanizing AI text or the guide on how to use Refineo with Claude Desktop for more details.