Getting Started

Starting fresh? Consider Resonant Mind instead — it’s the actively developed successor with more features.

Mind Cloud runs entirely on Cloudflare’s free tier. No credit card required.

Prerequisites

A Cloudflare account (free)
Node.js 18+

Setup

1. Clone and Install

git clone https://github.com/codependentai/mind-cloud.git
cd mind-cloud
npm install
npx wrangler login

2. Create Infrastructure

# Database
npx wrangler d1 create ai-mind

# Vector index for semantic search
npx wrangler vectorize create ai-mind-vectors --dimensions=768 --metric=cosine

# Image storage (optional)
npx wrangler r2 bucket create mind-cloud-images

3. Configure

cp wrangler.toml.example wrangler.toml

Edit wrangler.toml and replace REPLACE_WITH_YOUR_DATABASE_ID with the ID from step 2.

4. Set Secrets

npx wrangler secret put MIND_API_KEY
# Enter any strong random string — this authenticates all requests

5. Deploy

# Run database migration
npx wrangler d1 migrations apply ai-mind --remote

# Deploy
npx wrangler deploy

6. Connect to Claude

Add to your MCP configuration:

{
  "mcpServers": {
    "mind": {
      "type": "url",
      "url": "https://ai-mind.your-subdomain.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MIND_API_KEY"
      }
    }
  }
}

7. Test

"Use mind_orient to wake up"
"Write an observation about testing Mind Cloud"
"Search my memories"

When to Migrate

Mind Cloud works well and continues to receive maintenance. Consider migrating to Resonant Mind when you need:

Postgres support for larger datasets
Multimodal embeddings (images searchable alongside text)
Enhanced security features
New tools and active development