Anthropic Integration - RecallrAI Documentation

Recallr seamlessly integrates with Anthropic by acting as a forward proxy. Simply point your Anthropic client to our base URL and we’ll inject relevant context from user memory into each request.

Quick Start

from anthropic import Anthropic

client = Anthropic(
    base_url='https://api.recallrai.com/api/v1/forward/https://api.anthropic.com',
    api_key='sk-ant-...',  # Your Anthropic API key
    default_headers={
        'X-Recallr-API-Key': 'rai-...',
        'X-Recallr-Project-Id': 'your-project-id',
        'X-Recallr-Allow-New-User-Creation': 'true',
        'X-Recallr-Session-Timeout-Seconds': '600', # Optional
    }
)

# Use normally - memory is automatically injected
response = client.messages.create(
    model="claude-4-5-sonnet",
    messages=[{"role": "user", "content": "My name is Alice"}],
    extra_headers={
        'X-Recallr-User-Id': 'alice-123',
        'X-Recallr-Recall-Strategy': 'low_latency',  # Optional
    }
)

print(response.content[0].text)

Supported APIs

Messages API

Anthropic’s Messages API with streaming and non-streaming support

Required Headers

These headers must be included with every request:

string

required

Your Recallr API key. Get it from the dashboard.

string

required

Your Recallr Project ID. Get it from the dashboard.

string

required

Unique identifier for the user. Used to maintain separate memory graphs per user.

Can also be passed as user field in the request body for OpenAI compatibility.

Optional Headers

Session Management

boolean

default:"false"

Automatically create a new user if the specified User-ID doesn’t exist. Set to true to avoid errors for new users.

integer

default:"600"

Inactivity period (in seconds) before creating a new session. Minimum value is 600 (10 minutes).

Messages within a session are always passed directly to the LLM. Only memories from previous sessions are retrieved and injected as context.

Recall Configuration

string

default:"balanced"

Controls the recall method used for retrieving memories. Affects latency and accuracy.

low_latency
balanced
Agentic

Best for: Voice agents and real-time applications

Fastest response time
Retrieves more memories to compensate for reduced accuracy
Use when sub-second latency is critical

integer

default:"10"

Minimum number of memories to retrieve from the knowledge graph.

integer

default:"50"

Maximum number of memories to retrieve from the knowledge graph.

float

default:"0.7"

Similarity threshold for retrieving individual memories (0.0 to 1.0). Lower values retrieve more memories.

float

default:"0.6"

Similarity threshold for retrieving session summaries (0.0 to 1.0). Lower values retrieve more summaries.

integer

Include last N messages from past sessions when building context.

integer

Include last N session summaries when building context.

string

default:"UTC"

User’s timezone for formatting timestamps in memory context (e.g., “America/New_York”, “Europe/London”). Defaults to UTC if not specified.

Providing the user’s timezone improves temporal context by showing memories with locally-formatted timestamps.

boolean

default:"true"

Whether to include Recallr AI’s system prompt (~ 3k tokens) in the context. This prompt includes instructions for how to use the injected memories. Set to false if you already have those instructions in your system prompt.

Response Headers

Recallr returns these headers in the response for debugging and session tracking:

string

The internal session ID used by Recallr. Use this to continue the same session in future requests.

string

Unique identifier for the user. Matches the X-Recallr-User-Id sent in the request.

string

Unique identifier for this request. Use for debugging and tracing.

string

Time taken to process the request on Recallr’s side (in milliseconds).

Examples

Messages API - Non-Streaming

from anthropic import Anthropic

client = Anthropic(
    base_url='https://api.recallrai.com/api/v1/forward/https://api.anthropic.com',
    api_key='sk-ant-...',  # Your Anthropic API key
    default_headers={
        'X-Recallr-API-Key': 'rai-...',
        'X-Recallr-Project-Id': 'project-id',
        'X-Recallr-Allow-New-User-Creation': 'true',
        'X-Recallr-Session-Timeout-Seconds': '600', # Optional
    }
)

response = client.messages.with_raw_response.create(
    model="claude-4-5-sonnet",
    system="You are a helpful assistant.",
    messages=[
        {"role": "user", "content": "My name is Alice and I love Python programming."}
    ],
    extra_headers={
        'X-Recallr-User-Id': 'alice-123',
        'X-Recallr-Recall-Strategy': 'low_latency', # Optional
    }
)

# Access headers
session_id = raw_response.headers.get('X-Recallr-Session-Id')
request_id = raw_response.headers.get('X-Recallr-Request-Id')

# Parse response
response = raw_response.parse()
print(response.content[0].text)

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  baseURL: 'https://api.recallrai.com/api/v1/forward/https://api.anthropic.com',
  apiKey: 'sk-ant-...',  // Your Anthropic API key
  defaultHeaders: {
    'X-Recallr-API-Key': 'rai-...',
    'X-Recallr-Project-Id': 'project-id',
    'X-Recallr-Allow-New-User-Creation': 'true',
    'X-Recallr-Session-Timeout-Seconds': '600', // Optional
  },
});

const response = await client.messages.create({
  model: 'claude-4-5-sonnet',
  system: 'You are a helpful assistant.',
  messages: [
    { role: 'user', content: 'My name is Alice and I love Python programming.' }
  ],
  extraHeaders: {
    'X-Recallr-User-Id': 'alice-123',
    'X-Recallr-Recall-Strategy': 'low_latency', // Optional
  }
});

console.log(response.content[0].text);

Messages API - Streaming

from anthropic import Anthropic

client = Anthropic(
    base_url='https://api.recallrai.com/api/v1/forward/https://api.anthropic.com',
    api_key='sk-ant-...', # Your Anthropic API key
    default_headers={
        'X-Recallr-API-Key': 'rai-...',
        'X-Recallr-Project-Id': 'project-id',
        'X-Recallr-Allow-New-User-Creation': 'true',
        'X-Recallr-Session-Timeout-Seconds': '600', # Optional
    }
)

with client.messages.stream(
    model="claude-4-5-sonnet",
    system="You are a helpful assistant.",
    messages=[
        {"role": "user", "content": "What do you know about me and my interests?"}
    ],
    extra_headers={
        'X-Recallr-User-Id': 'alice-123',
        'X-Recallr-Recall-Strategy': 'low_latency',  # Optional
    }
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  baseURL: 'https://api.recallrai.com/api/v1/forward/https://api.anthropic.com',
  apiKey: 'sk-ant-...',  // Your Anthropic API key
  defaultHeaders: {
    'X-Recallr-API-Key': 'rai-...',
    'X-Recallr-Project-Id': 'project-id',
    'X-Recallr-Allow-New-User-Creation': 'true',
    'X-Recallr-Session-Timeout-Seconds': '600', // Optional
  },
});

const stream = client.messages.stream({
  model: 'claude-4-5-sonnet',
  system: 'You are a helpful assistant.',
  messages: [
    { role: 'user', content: 'What do you know about me and my interests?' }
  ],
});

for await (const chunk of stream) {
  if (chunk.type === 'content_block_delta' && chunk.delta?.type === 'text_delta') {
    process.stdout.write(chunk.delta.text);
  }
}

How It Works

Need Help?

Contact our support team for assistance with Anthropic integration

​Quick Start

​Supported APIs

Messages API

​Required Headers

​Optional Headers

​Session Management

​Recall Configuration

​Response Headers

​Examples

​Messages API - Non-Streaming

​Messages API - Streaming

​How It Works

Need Help?

Quick Start

Supported APIs

Required Headers

Optional Headers

Session Management

Recall Configuration

Response Headers

Examples

Messages API - Non-Streaming

Messages API - Streaming

How It Works