Skip to main content

​
1. Get Your API Key

Log into the Ruune Dashboard and navigate to Settings → API Keys. Click Create Key and copy the generated key. It starts with ruune_sk_.
Store your API key securely. It grants full access to your account data. Never expose it in client-side code.

​
2. Make Your First Request

List your most recent notes:
cURL
curl https://api.ruune.ai/v1/notes \
  -H "Authorization: Bearer ruune_sk_live_xxxxxxxxxxxxx"
You should get a JSON response with your notes:
Response
{
  "data": [
    {
      "id": "note_abc123",
      "title": "Product Sync with Sarah",
      "summary": "Discussed Q3 roadmap priorities...",
      "created_at": "2026-06-15T14:30:00Z",
      "duration_seconds": 1820,
      "tags": ["meeting", "product"]
    }
  ],
  "meta": { "page": 1, "per_page": 20, "total": 5 }
}

​
3. Search Your Memory

Use semantic search to find anything across all your captured context:
cURL
curl -X POST https://api.ruune.ai/v1/search \
  -H "Authorization: Bearer ruune_sk_live_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"query": "What did Sarah say about the API launch?"}'

​
4. Connect an AI Agent (MCP)

Add Ruune to your Claude Desktop or any MCP-compatible client:
claude_desktop_config.json
{
  "mcpServers": {
    "ruune": {
      "url": "https://mcp.ruune.ai",
      "headers": {
        "Authorization": "Bearer ruune_sk_live_xxxxxxxxxxxxx"
      }
    }
  }
}
Now Claude can search your notes, get transcripts, list action items, and more — all through natural conversation.

​
Next Steps

  • Authentication — Learn about API keys, scopes, and security best practices.
  • Notes API — Full CRUD reference for notes.
  • MCP Server — Deep dive into MCP tools and configuration.