Quick Start

Get textrawl running and connected to Claude Desktop in 5 minutes.

Prerequisites

git clone https://github.com/jeffgreendesign/textrawl.git
cd textrawl
pnpm install

The setup script creates your .env file with secure defaults:

pnpm run setup

You'll be prompted for:

In the Supabase SQL Editor, run:

-- Paste contents of scripts/setup-db.sql

Then run the security script:

-- Paste contents of scripts/security-rls.sql

pnpm run dev

Server runs at http://localhost:3000

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "textrawl": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

Restart Claude Desktop to connect.

pnpm run inspector

Opens a web UI at http://localhost:5173 to test MCP tools.

Ask Claude:

"Use the search_knowledge tool to find documents about getting started"

If no documents exist yet, add a test note:

"Use add_note to create a note titled 'Test Note' with content 'This is a test of textrawl'"

Then search for it:

"Search for 'test' in my knowledge base"

Verify your .env has valid Supabase credentials:

SUPABASE_URL=https://your-project.supabase.co
SUPABASE_SERVICE_KEY=your-service-key

Ensure OPENAI_API_KEY is set in .env