Connectors
Connectors let you extend Aiffinity in two directions:
- Outbound (Soul Sharing) — share your personality, communication style, and preferences with external AI tools so they understand you instantly.
- Inbound (Data Sources) — connect your apps and services so Aiven can analyse your activity patterns and build a richer, more accurate AI Soul.
All data source connectors request read-only access. Aiffinity cannot modify, delete, or post to any connected service. You can disconnect at any time.
How Soul Sharing Works
Your Personal Soul Token, API endpoints, and scopes.
AI Assistants
ChatGPT, Gemini, Claude, Copilot, Perplexity, Grok, DeepSeek.
Automation & Agents
Zapier, Make, n8n, LangChain, OpenClaw, Custom API.
Work & Productivity
Notion, Slack, Discord, Jira, Linear, Obsidian, Raycast, GitHub Copilot, Cursor.
Voice & OS Assistants
Apple Siri and Amazon Alexa integrations.
Data Sources
Spotify, Reddit, X, Bluesky, Oura, Strava, Google, Outlook, Apple Health.
How Soul Sharing Works
Soul Sharing lets you bring your personality to any AI tool. Instead of starting from scratch with every new app, your Soul provides instant context — your communication style, preferences, values, and tone — so the AI feels like it already knows you.
Your Personal Soul Token
Every outbound connector uses your Personal Soul Token — a secure API key that grants read-only access to your Soul data. To get your token:
- Open Settings > Connected Apps in the Aiffinity app.
- Your Personal Soul Token is shown at the top of the page.
- Copy it and paste it into the external service.
Your Soul Token is like a password — keep it private. Anyone with your token can read your Soul data. You can regenerate it at any time from Settings, which instantly revokes the old token.
Soul API Endpoints
Different connectors use different endpoints depending on what data they need:
| Endpoint | What It Returns | Best For |
|---|---|---|
/v1/soul/prompt |
LLM-ready prompt pack with your style guide, preferences, and communication patterns | AI assistants, chatbots, writing tools |
/v1/soul/snapshot |
Structured personality data with dimension scores and trait analysis | Automation workflows, data pipelines, agent frameworks |
/v1/soul/capsule |
Brief summary of who you are with interaction hints | Quick context, lightweight integrations |
Scopes
Each connector requests specific scopes that control what Soul data it can access:
- soul:prompt_pack:read — your communication style and preferences
- soul:snapshot:read — your personality profile
- soul:capsule:read — a brief summary of who you are
AI Assistants
Personalize your favourite AI assistants with your Soul. Each assistant receives your communication style and preferences so its responses feel tailored to you.
ChatGPT
Personalize ChatGPT with your communication style and preferences. Works with any Custom GPT you create or use.
What It Does
- Exports your communication style to ChatGPT via Custom GPT Actions
- ChatGPT automatically fetches your Soul when you start a conversation
- Responses match your tone, formality, and personality
How to Connect
- Copy your Personal Soul Token from the Connectors page in the Aiffinity app.
- In ChatGPT, create or edit a Custom GPT.
- Go to Configure → Actions → Create new action.
- Set Authentication to API Key, header
Authorization, prefixBearer. - Import the OpenAPI spec from
https://soul-api.aiffinity.me/openapi.json. - Test the action — ChatGPT will now know your style.
Privacy
Your Soul data will be sent to OpenAI's servers when ChatGPT fetches your profile. Only data matching the requested scopes is shared. Revoke your token at any time to stop sharing.
Google Gemini
Personalize Gemini responses with your communication style. Works with Google AI Studio and custom apps.
What It Does
- Personalizes Gemini responses with your style guide
- Use as a system prompt in Gemini API integrations
- Works with Google AI Studio and custom applications
How to Connect
- Copy your Personal Soul Token from the Connectors page.
- In your Gemini integration, fetch your Soul prompt pack from the API.
- Use the returned
style_guideas Gemini's system prompt. - Include the
preferencesobject to further customize behaviour.
Privacy
Your Soul data will be sent to Google's servers. Review Google's privacy policy. Revoke your token at any time.
Claude
Share your style guide with Claude for personalized conversations. Use in Claude Projects or API integrations.
What It Does
- Shares your style guide with Claude conversations
- Works with Claude Projects, the API, and custom integrations
- Your preferences shape Claude's tone and behaviour
How to Connect
- Copy your Personal Soul Token from the Connectors page.
- In your Claude integration, fetch the Soul prompt pack before conversations.
- Include the
style_guidein Claude's system prompt. - Use the
preferencesobject to customize behaviour.
Privacy
Your Soul data will be sent to Anthropic's servers. Only use with trusted applications. Revoke your token at any time.
Microsoft Copilot
Personalize Copilot Studio skills with your Soul. Works with enterprise Copilot deployments.
What It Does
- Personalizes Copilot Studio skills with your Soul data
- Works with enterprise Copilot deployments and custom plugins
- Custom plugins fetch your preferences automatically
How to Connect
- Copy your Personal Soul Token from the Connectors page.
- In Copilot Studio, create a new plugin or skill.
- Add an HTTP action to fetch your Soul prompt pack from the API.
- Use the returned data to customize Copilot's responses.
Privacy
Your Soul data will be processed by Microsoft. Review your organization's data policies.
Perplexity
Tailor Perplexity search answers to your communication style and preferences.
What It Does
- Tailors search answers to your communication style
- Paste your Soul into Custom Instructions for personalized results
- Answers reflect your preferences and tone
How to Connect
- Copy your Personal Soul Token from the Connectors page.
- In Perplexity, go to your profile settings.
- Paste your Soul Prompt Pack into "Custom Instructions".
- Perplexity will use your style preferences in all responses.
Privacy
Your Soul data will be sent to Perplexity's servers. Review their privacy policy.
Grok
Personalize Grok conversations with your communication style. Use on X or the standalone Grok app.
What It Does
- Personalizes Grok conversations with your style
- Paste into personalization settings on X or the Grok app
- Responses adapt to your communication preferences
How to Connect
- Copy your Personal Soul Token from the Connectors page.
- Use your Soul Prompt Pack as custom instructions when chatting with Grok.
- On X or the Grok app, paste into your personalization settings.
Privacy
Your Soul data will be sent to xAI's servers. Review their privacy policy.
DeepSeek
Share your style with DeepSeek for personalized AI assistance in chat and code.
What It Does
- Shares your style with DeepSeek Chat
- Use as a system prompt or via the DeepSeek API
- Personalizes code and conversation responses
How to Connect
- Copy your Personal Soul Token from the Connectors page.
- Paste your Soul Prompt Pack as a system prompt in DeepSeek Chat.
- Or use the token with the DeepSeek API for programmatic access.
Privacy
Your Soul data will be sent to DeepSeek's servers. Review their privacy policy.
Automation & Agents
Bring personality context to your workflows and AI agents. These connectors let you fetch your Soul data via REST API and use it in any automation pipeline.
Zapier
Fetch your personality data in Zap workflows. Add Soul context to any automated workflow.
What It Does
- Fetches your personality data in Zap workflows
- Use with the Webhooks by Zapier action
- Add Soul context to any automated workflow
How to Connect
- Copy your Personal Soul Token from the Connectors page.
- In Zapier, add a "Webhooks by Zapier" action.
- Choose "Custom Request" or "GET".
- URL:
https://soul-api.aiffinity.me/v1/soul/snapshot - Add Header:
Authorization: Bearer YOUR_TOKEN - Use the returned data in subsequent Zap steps.
Privacy
Your Soul data will pass through Zapier's servers. Use secure connections only.
Make
Pull your Soul data into Make scenarios. Enrich automations with personality context.
What It Does
- Pulls your Soul data into Make scenarios
- Use with the HTTP module
- Enrich automations with personality context
How to Connect
- Copy your Personal Soul Token from the Connectors page.
- In Make, add an HTTP module to your scenario.
- Configure a GET request to
https://soul-api.aiffinity.me/v1/soul/snapshot. - Add the
Authorizationheader with your Bearer token. - Parse the JSON response and use in subsequent modules.
Privacy
Your Soul data will be processed by Make's infrastructure.
n8n
Integrate Soul data into self-hosted workflows. Full control over your data in your own infrastructure.
What It Does
- Integrates Soul data into self-hosted n8n workflows
- Use with the HTTP Request node
- Full control over your data in your own infrastructure
How to Connect
- Copy your Personal Soul Token from the Connectors page.
- In n8n, add an HTTP Request node.
- Method: GET
- URL:
https://soul-api.aiffinity.me/v1/soul/snapshot - Authentication: Generic Credential Type → Header Auth
- Header Name:
Authorization, Value:Bearer YOUR_TOKEN
Privacy
Your Soul data will be processed by your n8n instance. Secure your deployment appropriately.
LangChain
Build LangChain applications with Soul-aware context. Use as a custom tool in RAG pipelines.
What It Does
- Provides Soul context to LangChain applications
- Use as a custom tool in RAG pipelines
- Both snapshot and prompt pack endpoints available
How to Connect
- Copy your Personal Soul Token from the Connectors page.
- Create a custom LangChain tool that fetches Soul data from the API.
- Use the snapshot for context in RAG pipelines.
- Use the prompt pack for system prompt customization.
Privacy
Your Soul data will be used in your LangChain application. Ensure proper data handling in your deployment.
Agent Frameworks
Give personality context to AI agents built with AutoGen, CrewAI, and other multi-agent frameworks.
What It Does
- Gives personality context to AI agents
- Works with AutoGen, CrewAI, and other multi-agent frameworks
- Agents understand your communication style and act accordingly
How to Connect
- Copy your Personal Soul Token from the Connectors page.
- In your agent framework, create an HTTP tool that fetches Soul data.
- Use the snapshot to provide personality context to agents.
- Use the prompt pack for system prompt customization.
Privacy
The agent framework will access your Soul data. Ensure proper data handling in your deployment.
OpenClaw
Connect your autonomous AI agent to your Soul for personalized task execution. Works with Claude, GPT, and local models via Ollama.
What It Does
- OpenClaw fetches your Soul to personalize task execution
- Activity and interaction patterns flow back to enrich your profile
- Works with Claude, GPT, and local models via Ollama
How to Connect
- Install OpenClaw:
npm install -g openclaw@latest - Run
openclaw onboard --install-daemon - Copy your Personal Soul Token from the Connectors page.
- Add
AIFFINITY_SOUL_TOKENto your OpenClaw config.
Privacy
OpenClaw runs locally on your machine with full system access. Your Soul data stays on your device. This connector is bidirectional — interaction patterns flow back to enrich your Soul.
Custom API
Connect any application via the Soul REST API. Full documentation and ETag caching support.
What It Does
- Connect any application via REST API
- Choose from snapshot, prompt, or capsule endpoints
- Full documentation and ETag caching support for efficient polling
How to Connect
- Copy your Personal Soul Token from the Connectors page.
- Choose the endpoint that fits your use case:
/v1/soul/snapshot— Structured personality data/v1/soul/prompt— LLM-ready prompt customization/v1/soul/capsule— Brief summary with interaction hints
- Make HTTP GET requests with your Bearer token in the
Authorizationheader. - Use the
ETag/If-None-Matchheaders to avoid unnecessary re-fetches.
Privacy
Your Soul data will be sent to the receiving application. Only use with trusted services. Revoke your token at any time to stop all sharing.
Meta AI
Personalize Meta AI across WhatsApp, Instagram, and Messenger with your Soul.
What It Does
- Use your Soul personality context with Meta AI features
- Personalize Meta AI responses across Meta platforms
- Build soul-aware automations via Meta's AI platform
How to Connect
- Copy your Personal Soul Token from the Connectors page.
- Use the Soul API to fetch your personality context.
- Inject the context into Meta AI prompts or integrations.
Privacy
Your Soul data is shared read-only via your personal token. Revoke the token at any time to stop sharing.
Work & Productivity
Bring your personality to the tools you use every day. These connectors customize AI-powered writing, coding, and collaboration features with your style.
Notion
Personalize Notion AI with your writing style and personality.
What It Does
- Personalizes Notion AI writing with your style
- AI suggestions match your tone across Notion
- Custom integrations adapt to your communication preferences
How to Connect
- Use with Notion's API or custom integrations.
- Fetch your Soul prompt pack to customize AI writing assistance.
- Include style preferences in your Notion automation scripts.
Privacy
Your Soul data may be sent to Notion's AI services for writing personalization.
Slack
Customize Slack bot responses with your communication style.
What It Does
- Customizes Slack bot responses with your style
- Fetch Soul data on bot startup for consistent personalization
- Bot messages reflect your communication preferences
How to Connect
- In your Slack bot backend, fetch the Soul prompt pack using your token.
- Use the
style_guideto customize bot responses. - Include preferences for tone and communication style.
Privacy
Your Soul data will be used in Slack conversations via your bot.
Discord
Personalize Discord bots with your communication style.
What It Does
- Personalizes Discord bot interactions with your style
- Bot adapts to your communication tone and preferences
- Custom bots can fetch your Soul data on startup
How to Connect
- Copy your Personal Soul Token from the Connectors page.
- In your Discord bot, fetch the Soul prompt pack on startup.
- Use the
style_guideto customize bot response tone.
Privacy
The Discord bot will use your personalization data. Review the bot's privacy policy.
Jira / Confluence
Personalize Atlassian AI features with your Soul.
What It Does
- Personalizes Atlassian AI features with your style
- Use with Forge apps or custom integrations
- Generated content matches your writing style
How to Connect
- Use with Atlassian Forge apps or custom integrations.
- Fetch Soul data to customize AI writing suggestions.
- Apply style preferences to generated content.
Privacy
Your Soul data may be processed by Atlassian's AI services.
Linear
Tailor Linear AI to your communication style.
What It Does
- Tailors Linear AI to your communication style
- Use with Linear API integrations
- Issue descriptions match your tone
How to Connect
- Use with Linear's API or integrations.
- Fetch Soul data for personalized issue descriptions.
- Apply communication style to generated content.
Privacy
Your Soul data may be used in Linear's AI features.
Obsidian
Power Obsidian AI plugins with your writing style.
What It Does
- Powers Obsidian AI plugins with your style
- Works with Smart Connections, Copilot, and other AI plugins
- AI writing matches your voice
How to Connect
- Copy your Personal Soul Token from the Connectors page.
- Use your Soul Prompt Pack with Obsidian AI plugins (e.g., Smart Connections, Copilot).
- Paste as a system prompt in the plugin settings.
Privacy
The Obsidian plugin may process your data locally or via cloud. Check the plugin's policy.
Raycast
Personalize Raycast AI commands with your communication style.
What It Does
- Personalizes Raycast AI commands with your style
- Paste Soul into Raycast AI settings for instant personalization
- Responses match your communication style
How to Connect
- Copy your Personal Soul Token from the Connectors page.
- In Raycast, go to Settings > AI.
- Paste your Soul Prompt Pack into "Custom Instructions".
Privacy
Raycast may store your personalization data. Review their privacy policy.
GitHub Copilot
Adapt GitHub Copilot to your coding communication style.
What It Does
- Adapts Copilot to your coding communication style
- Add to
.github/copilot-instructions.mdfor project-wide personalization - Code suggestions and chat responses reflect your preferences
How to Connect
- Copy your Personal Soul Token from the Connectors page.
- Add your Soul Prompt Pack to
.github/copilot-instructions.mdin your repo. - Or paste into GitHub Copilot settings under personalization.
Privacy
GitHub may store your personalization data. Review their privacy policy.
Cursor AI
Personalize Cursor AI editor responses with your style.
What It Does
- Personalizes Cursor AI editor responses
- Add to
.cursorrulesor Rules for AI - AI pair programming in your style
How to Connect
- Copy your Personal Soul Token from the Connectors page.
- Add your Soul Prompt Pack to your
.cursorrulesfile. - Or paste into Cursor Settings > Rules for AI.
Privacy
Cursor may store your personalization data. Review their privacy policy.
Voice & OS Assistants
Bring your Soul to voice assistants and OS-level AI features.
Apple Siri / Apple Intelligence
Personalize Siri and Apple Intelligence with your Soul for context-aware responses.
What It Does
- Inject your Soul into Siri Shortcuts for personalized responses
- Use your Soul personality context in Apple Intelligence features
- Combine with Shortcuts automations for soul-aware workflows
How to Connect
- Copy your Personal Soul Token from the Connectors page.
- In Shortcuts, create a new shortcut with a "Get Contents of URL" action.
- Set the URL to your Soul API endpoint with the Bearer token.
- Use the returned personality context in downstream Siri actions.
Privacy
Your Soul data is shared read-only with Siri via your personal token. Revoke the token at any time to stop sharing.
Amazon Alexa
Share your Soul with Alexa Skills for personalized voice interactions.
What It Does
- Personalize Alexa Skills with your communication style
- Inject Soul personality context into custom Alexa responses
- Build soul-aware voice experiences via the Alexa Skills Kit
How to Connect
- Copy your Personal Soul Token from the Connectors page.
- In your Alexa Skill backend, call the Soul API with the Bearer token.
- Use the returned personality context to customize Alexa responses.
Privacy
Your Soul data is shared read-only with Alexa via your personal token. Revoke the token at any time to stop sharing.
Data Sources
Data sources pull information from your apps and services to enrich your AI Soul. Aiven analyses your activity patterns — what you listen to, how you exercise, how you communicate — and uses those signals to build a more accurate picture of your personality. This means better conversations, better recommendations, and a deeper understanding of who you are.
How Data Sources Work
- Open Settings > Connected Apps in the Aiffinity app.
- Choose a service and tap Connect.
- Sign in to the service and approve read-only access.
- Your data syncs automatically in the background.
- Aiven analyses the data and maps it to personality dimensions in your AI Soul.
To manage or disconnect any service, return to Settings > Connected Apps and tap the connected service.
Spotify
Reddit
X
Bluesky
Oura Ring
Strava
Google Calendar
Google Drive
Google Contacts
Outlook
Apple Health
Spotify
Your music taste is one of the strongest personality signals. Connecting Spotify lets Aiffinity understand your aesthetic preferences, energy levels, and openness to new experiences through your listening patterns.
What Data Is Accessed
Aiffinity requests read-only access to:
- Your top artists and top tracks (all time, last 6 months, last 4 weeks)
- Your followed artists
- Your saved tracks (liked songs)
- Your playlists
- Your recently played tracks
Aiffinity cannot play, pause, skip, or modify your Spotify account in any way.
How It Enriches Your AI Soul
Your listening data maps to personality dimensions:
- Openness — genre diversity and breadth of followed artists. Listening across 20+ genres signals high openness to new experiences.
- Energy Level — average energy and tempo of your top tracks. High-energy playlists indicate a more energetic personality.
- Conscientiousness — how curated your library is. Creating playlists and saving tracks signals intentional music curation.
How to Connect
- Open Settings > Connected Apps in the Aiffinity app.
- Find Spotify and tap Connect.
- Sign in to your Spotify account when prompted.
- Approve read-only access to your listening data.
- Your listening history begins syncing automatically.
Managing Your Connection
View your Spotify connection status in Settings > Connected Apps. You can see when data was last synced and your connected account name (your Spotify display name or username).
How to Disconnect
- Go to Settings > Connected Apps.
- Tap Spotify.
- Tap Disconnect.
- Optionally, also revoke access from spotify.com/account/apps.
Privacy
Your playlists, song titles, and listening history are analysed for personality signals and then discarded. Only the resulting personality dimension scores (numbers like "openness: 0.7") are stored in your Soul profile. Your actual music library is not permanently retained on Aiffinity servers.
Troubleshooting
- "Connection failed" — Try signing out of Spotify in your browser first, then reconnect from the app.
- "No enrichment appearing" — You need sufficient listening history. New Spotify accounts with limited data may not produce meaningful personality signals.
- "Wrong account connected" — Disconnect, then reconnect and ensure you sign in to the correct Spotify account.
Reddit
Your Reddit activity reveals your interests, how you engage with communities, and what content you find worth saving. Connecting Reddit helps Aiven understand the breadth and depth of your curiosity.
What Data Is Accessed
Aiffinity requests read-only access to:
- Your subscribed subreddits
- Your comments and submitted posts
- Your saved items
- Your upvoted content
- Your account identity (username)
Aiffinity cannot post, comment, vote, or modify your Reddit account. Private messages are never accessed.
How It Enriches Your AI Soul
- Openness — subreddit diversity. Being active across 15+ different communities signals curiosity and openness to varied interests.
- Extraversion — comment and post volume. Active contributors who engage frequently in discussions show higher social engagement.
- Conscientiousness — saved content curation. Regularly saving posts for later reference signals intentional information management.
How to Connect
- Open Settings > Connected Apps in the Aiffinity app.
- Find Reddit and tap Connect.
- Sign in to your Reddit account when prompted.
- Approve read-only access.
- Your Reddit activity begins syncing automatically.
Managing Your Connection
View your Reddit connection in Settings > Connected Apps. Your connected account shows as u/yourusername.
How to Disconnect
- Go to Settings > Connected Apps.
- Tap Reddit.
- Tap Disconnect.
- Optionally, revoke access from reddit.com/prefs/apps.
Privacy
Only public posts and comments are analysed. Private messages are never accessed. Subreddit names and engagement counts are used to calculate personality scores, then the raw data is discarded. Only the resulting dimension scores are stored.
Troubleshooting
- "Connection failed" — Reddit requires you to be logged in. Ensure you are signed in to Reddit in your browser before connecting.
- "Very low confidence score" — New Reddit accounts with limited activity will produce low-confidence personality signals. Continue using Reddit and re-sync.
X
Your posts and interactions on X reveal how you express yourself publicly — your communication style, social engagement, and how you interact with others.
What Data Is Accessed
Aiffinity requests read-only access to:
- Your posts
- Your liked posts
- Your public profile information
Aiffinity cannot post, like, repost, follow, or modify your X account. Direct messages are never accessed.
How It Enriches Your AI Soul
- Extraversion — post volume. Frequent posters demonstrate higher social expressiveness.
- Agreeableness — reply ratio. Users who frequently reply to others (vs. standalone posts) show higher social engagement and agreeableness.
How to Connect
- Open Settings > Connected Apps in the Aiffinity app.
- Find X and tap Connect.
- Sign in to your X account when prompted.
- Approve read-only access to your posts and likes.
- Your post history begins syncing automatically.
Managing Your Connection
Your connected account shows as @yourusername in Settings > Connected Apps.
How to Disconnect
- Go to Settings > Connected Apps.
- Tap X.
- Tap Disconnect.
- Optionally, revoke access from X Settings > Security > Apps.
Privacy
Only public posts are analysed. Direct messages and private account content are never accessed. Post text is processed for personality patterns and then discarded. The connection uses PKCE (Proof Key for Code Exchange) for enhanced security — no client secret is stored on your device.
Troubleshooting
- "Connection failed" — Ensure you have a public X account. Private/protected accounts may have limited data access.
- "Low confidence" — X produces lower confidence scores compared to other connectors. This is normal — post data alone provides a narrower personality signal.
Bluesky
Bluesky is a decentralised social network built on the AT Protocol. Connecting Bluesky lets Aiffinity understand your social patterns, content curation, and values through your activity on the network.
What Data Is Accessed
Aiffinity accesses:
- Your posts (feed)
- Your follows
- Your likes
- Your lists (curated collections)
- Your labeler subscriptions (content moderation preferences)
Aiffinity cannot post, like, follow, or modify your Bluesky account.
How It Enriches Your AI Soul
- Extraversion — post expressiveness and engagement breadth. Frequent posters and active likers show higher social engagement.
- Openness — follow graph size. Following a wide range of accounts signals curiosity and openness.
- Conscientiousness — list curation and labeler subscriptions. Creating organised lists and subscribing to content moderation labelers signals intentional information management and values awareness.
How to Connect
Bluesky uses credential-based linking (not OAuth). You need to create an app password:
- Go to bsky.app/settings/app-passwords and create a new app password.
- Open Settings > Connected Apps in the Aiffinity app.
- Find Bluesky and tap Connect.
- Enter your Bluesky handle (e.g.
yourname.bsky.social) and the app password you just created. - Your Bluesky data begins syncing automatically.
Use a dedicated app password for Aiffinity — never share your main account password. App passwords can be revoked individually without affecting your Bluesky account.
Managing Your Connection
Your connected account shows as your Bluesky handle in Settings > Connected Apps.
How to Disconnect
- Go to Settings > Connected Apps.
- Tap Bluesky.
- Tap Disconnect.
- Revoke the app password at bsky.app/settings/app-passwords.
Privacy
Bluesky is built on an open protocol — all data accessed is publicly available on the AT Protocol network. Your app password is stored encrypted and is used solely to authenticate API requests. Post content is processed for personality patterns and discarded.
Troubleshooting
- "Invalid credentials" — Ensure you are using an app password (not your account password) and that your handle is complete (e.g.
name.bsky.social). - "App password expired" — Create a new app password at bsky.app and reconnect.
Oura Ring
Your Oura Ring tracks sleep, stress, activity, and recovery. Connecting it gives Aiffinity deep insight into your wellness patterns, emotional resilience, and self-care habits.
What Data Is Accessed
Aiffinity requests read-only access to:
- Daily sleep scores and sleep stages
- Readiness scores
- Stress levels and recovery data
- Workout sessions
- Meditation and breathwork sessions
- Tags you create in the Oura app
- Heart rate and SpO2 data
Aiffinity cannot modify any data in your Oura account.
How It Enriches Your AI Soul
- Self-Regulation — sleep quality scores. Consistently high sleep scores indicate strong self-regulation habits.
- Energy Level — readiness scores. Your daily readiness reflects your available energy and recovery state.
- Emotional Stability — stress resilience. A high ratio of recovery-to-stress readings signals emotional resilience.
- Conscientiousness — workout frequency. Regular exercise (15+ workouts/month) signals high conscientiousness.
- Openness — meditation sessions and tag use. People who meditate and use tags to track their state show higher self-awareness.
How to Connect
- Open Settings > Connected Apps in the Aiffinity app.
- Find Oura Ring and tap Connect.
- Sign in to your Oura account when prompted.
- Approve read-only access to your health and wellness data.
- Your Oura data begins syncing automatically.
Managing Your Connection
Your connected account shows as your Oura email address in Settings > Connected Apps.
How to Disconnect
- Go to Settings > Connected Apps.
- Tap Oura Ring.
- Tap Disconnect.
- Optionally, revoke access from the Oura app or cloud.ouraring.com.
Privacy
Daily summary scores (sleep, readiness, stress) are synced — not raw sensor data. Biometric readings (heart rate, SpO2) are processed for wellness signals and discarded. Only personality dimension scores are stored. Raw health data is never permanently retained on Aiffinity servers.
Troubleshooting
- "No data syncing" — Ensure your Oura Ring is synced with the Oura app first. Aiffinity reads from Oura's cloud API, so your ring data must be uploaded to Oura's servers.
- "Low confidence" — New Oura users or users with limited data history will see lower confidence scores. Continue wearing your ring and the confidence will increase over time.
Strava
Your Strava activity history reveals your fitness consistency, sport variety, and social exercise habits. Whether you run, cycle, swim, or hike, Aiffinity uses your activity patterns to understand your discipline and adventurousness.
What Data Is Accessed
Aiffinity requests read-only access to:
- Your recent activities (type, duration, distance)
- Your all-time activity statistics (total runs, rides, swims)
- Your club memberships
Aiffinity cannot create, edit, or delete activities, and does not access exact GPS routes.
How It Enriches Your AI Soul
- Conscientiousness — activity consistency and long-term dedication. Regular exercise over time (200+ all-time activities) signals high discipline.
- Openness — sport variety. Participating in 5+ different sport types shows willingness to try new things.
- Extraversion — club membership. Being part of 5+ fitness clubs signals social engagement through sport.
How to Connect
- Open Settings > Connected Apps in the Aiffinity app.
- Find Strava and tap Connect.
- Sign in to your Strava account when prompted.
- Approve read-only access to your activities.
- Your activity data begins syncing automatically.
Managing Your Connection
Your connected account shows as your Strava name (e.g. "Alex Smith") in Settings > Connected Apps.
How to Disconnect
- Go to Settings > Connected Apps.
- Tap Strava.
- Tap Disconnect.
- Optionally, revoke access from strava.com/settings/apps.
Privacy
Activity summaries (type, duration, distance) are analysed. Exact GPS routes and location data are never stored on Aiffinity servers. Only personality dimension scores are retained.
Troubleshooting
- "No activities showing" — Ensure your activities are not set to "Only You" privacy on Strava. Aiffinity needs at least "Followers" visibility to read activity data via the API.
- "Only showing recent activities" — Strava's API provides recent activities per sync. All-time statistics are also included, so your long-term dedication score is still accurate.
Google Calendar
Your calendar reflects how you structure your time. Connecting Google Calendar lets Aiffinity understand your scheduling habits, routine consistency, and how busy you typically are.
What Data Is Accessed
Aiffinity requests read-only access to:
- Your calendar events (titles, times, duration)
- Whether events are recurring or one-off
Aiffinity cannot create, edit, or delete calendar events. Attendee details and event descriptions are not stored.
How It Enriches Your AI Soul
- Conscientiousness — schedule density. Having 60+ events in a sync window signals high time management and planning.
- Stability — routine consistency. A high ratio of recurring events to total events signals preference for routine and predictability.
How to Connect
- Open Settings > Connected Apps in the Aiffinity app.
- Find Google Calendar and tap Connect.
- Sign in to your Google account when prompted.
- Approve read-only access to your calendar.
- Your calendar data begins syncing automatically.
Managing Your Connection
Your connected account shows as your Google email address in Settings > Connected Apps.
How to Disconnect
- Go to Settings > Connected Apps.
- Tap Google Calendar.
- Tap Disconnect.
- Optionally, revoke access from myaccount.google.com/permissions.
Privacy
Event metadata (times, titles, recurring status) is processed for scheduling patterns. Full event details, attendee lists, and event descriptions are not stored. Only personality dimension scores are retained.
Troubleshooting
- "No events found" — Ensure you have events on your primary Google Calendar. Secondary or shared calendars may not be included in the initial sync.
- "Connection expired" — Google tokens expire periodically. Reconnect from Settings > Connected Apps to refresh access.
Google Drive
Your Google Drive reflects your productivity and working style. Connecting it lets Aiffinity understand how you create and organise digital content.
What Data Is Accessed
Aiffinity requests read-only access to:
- File metadata (file names, file types/MIME types, creation dates)
- Total file counts by type
Aiffinity cannot read the contents of your files, create, edit, or delete any files. Only file metadata (names and types) is accessed.
How It Enriches Your AI Soul
- Conscientiousness — document count. Having 30+ documents signals active productivity and content creation.
- Openness — file type variety. Working with 5+ different file types (docs, sheets, slides, images, etc.) signals versatility and breadth of work.
How to Connect
- Open Settings > Connected Apps in the Aiffinity app.
- Find Google Drive and tap Connect.
- Sign in to your Google account when prompted.
- Approve read-only access to your Drive files.
- Your file metadata begins syncing automatically.
Managing Your Connection
Your connected account shows as your Google email address in Settings > Connected Apps.
How to Disconnect
- Go to Settings > Connected Apps.
- Tap Google Drive.
- Tap Disconnect.
- Optionally, revoke access from myaccount.google.com/permissions.
Privacy
Only file metadata (names and types) is accessed — file contents are never read, downloaded, or stored. Only personality dimension scores are retained.
Troubleshooting
- "Low confidence score" — Google Drive provides a narrower personality signal compared to other connectors. This is expected.
Google Contacts
Your contact list reflects the size of your social network. Connecting Google Contacts gives Aiffinity a sense of how many people you stay in touch with.
What Data Is Accessed
Aiffinity requests read-only access to:
- Your contact count
- Contact names and labels
Aiffinity cannot add, edit, or delete contacts. Phone numbers and email addresses of your contacts are not stored.
How It Enriches Your AI Soul
- Extraversion — social graph size. Having 200+ contacts signals a large, active social network and higher extraversion.
How to Connect
- Open Settings > Connected Apps in the Aiffinity app.
- Find Google Contacts and tap Connect.
- Sign in to your Google account when prompted.
- Approve read-only access to your contacts.
- Your contact data begins syncing automatically.
Managing Your Connection
Your connected account shows as your Google email address in Settings > Connected Apps.
How to Disconnect
- Go to Settings > Connected Apps.
- Tap Google Contacts.
- Tap Disconnect.
- Optionally, revoke access from myaccount.google.com/permissions.
Privacy
Contact names and labels are used to understand your social network structure. Individual contact details (phone numbers, emails) are never stored on Aiffinity servers. Only the total count and resulting personality scores are retained.
Troubleshooting
- "Very few contacts detected" — Ensure you are connecting the Google account where your primary contacts are stored. Work accounts and personal accounts may have different contact lists.
Microsoft Outlook
Connecting Microsoft Outlook gives Aiffinity a comprehensive view of your professional communication style, scheduling habits, social network, and task management.
What Data Is Accessed
Aiffinity requests access to:
- Your emails (received and sent) — subject lines, timestamps, sender/recipient
- Your calendar events
- Your contacts
- Your people connections (Microsoft's ML-ranked contact suggestions)
- Your tasks and their completion status
Aiffinity processes email metadata and content for personality analysis. It cannot delete emails or modify your account.
How It Enriches Your AI Soul
- Conscientiousness — email volume, schedule density, and task completion rate. Consistently completing tasks and maintaining a dense calendar signals discipline.
- Agreeableness — email response rate. Replying to a high proportion of received emails signals attentiveness and cooperativeness.
- Extraversion — social graph size. Having a large number of contacts and ML-ranked people connections signals an active professional network.
How to Connect
- Open Settings > Connected Apps in the Aiffinity app.
- Find Microsoft Outlook and tap Connect.
- Sign in to your Microsoft account when prompted.
- Approve access to mail, calendar, contacts, and tasks.
- Your Outlook data begins syncing automatically.
Managing Your Connection
Your connected account shows as your Microsoft email address in Settings > Connected Apps.
How to Disconnect
- Go to Settings > Connected Apps.
- Tap Microsoft Outlook.
- Tap Disconnect.
- Optionally, revoke access from account.live.com/consent/Manage.
Privacy
Email content is processed via Microsoft Graph API for personality and communication style analysis, then discarded. Email body text is not permanently stored. Only personality dimension scores are retained. Calendar events, contacts, and tasks are similarly processed for patterns and not stored in raw form.
Troubleshooting
- "Connection failed" — Some Microsoft 365 business accounts require admin consent for third-party apps. Contact your IT administrator if you cannot grant permissions.
- "Only personal data showing" — If you connected a personal Microsoft account, you may not have access to enterprise features like People connections. Try connecting your work account instead.
Apple Health
Apple Health aggregates data from your iPhone, Apple Watch, and other health devices. Connecting it gives Aiffinity insight into your sleep, activity, and wellness patterns — similar to Oura, but using Apple's native HealthKit framework.
What Data Is Accessed
Aiffinity uses iOS HealthKit to access:
- Sleep data (duration, stages)
- Activity data (steps, active energy, exercise minutes)
- Heart rate data
- Workout sessions
You choose exactly which data types to share when granting HealthKit permission. Aiffinity cannot access data types you do not explicitly approve.
Apple Health is available on iOS only. This connector is not available on Android devices.
How It Enriches Your AI Soul
Similar to Oura Ring, your health data maps to wellness-related personality dimensions:
- Self-Regulation — sleep quality and consistency
- Energy Level — activity levels and recovery patterns
- Conscientiousness — workout frequency and exercise consistency
How to Connect
- Open Settings > Connected Apps in the Aiffinity app.
- Find Apple Health and tap Connect.
- iOS will show the HealthKit permission sheet — choose which data types to share.
- Your health data begins syncing automatically while the app is running.
Managing Your Connection
You can manage which data types Aiffinity can access in iOS Settings > Health > Data Access > Aiffinity.
How to Disconnect
- Go to Settings > Connected Apps in the Aiffinity app.
- Tap Apple Health.
- Tap Disconnect.
- You can also revoke access from iOS Settings > Health > Data Access > Aiffinity.
Privacy
Health data is aggregated into daily summaries before processing. Raw biometric data (individual heart rate readings, step-by-step movement data) is never stored on Aiffinity servers. All processing happens on-device where possible. Only the resulting personality dimension scores are transmitted and stored.
Troubleshooting
- "No data syncing" — Ensure you granted HealthKit permissions. Check iOS Settings > Health > Data Access > Aiffinity.
- "Missing workout data" — Workouts must be recorded via Apple Watch, iPhone, or a HealthKit-compatible app. Workouts from non-Apple devices may not appear in HealthKit.
- "Not available on my device" — Apple Health is only available on iOS. Android users can connect Strava, Oura, or other fitness services instead.
Platform Imports
Switching from another AI companion? Platform imports let you bring your conversation history, characters, and memories into Aiffinity so you don't have to start from scratch. Your existing chat history helps Aiven understand your personality and communication style from day one.
How Platform Imports Work
- Export your data from the other platform (method varies by platform).
- Upload the exported file in the Aiffinity app via Profile > Import History.
- Auto-detection — Aiffinity identifies the platform and parses the file format.
- Content moderation — messages are checked for safety before import.
- Preview — review what will be imported (personas, conversation count, message count).
- Accept or Reject — confirm to finalise the import, or reject to discard.
What Gets Imported
- Personas — AI characters/companions from the other platform become Aiffinity personas.
- Conversations — chat threads are preserved with their original structure.
- Messages — individual messages with sender, content, and timestamps.
Support Tiers
| Tier | Meaning |
|---|---|
| TIER A | Fully supported with optimised parsers. Best import quality. |
| TIER B | Supported with some limitations. Most data is imported correctly. |
| TIER C | Basic support. May require data preparation before upload. |
| TIER D | Generic fallback. Works with any compatible file format. |
Kindroid TIER A
Kindroid is an AI companion platform. Aiffinity supports full import of your chat history, backstories, and key memories.
How to Export
- Install the KinX export tool from github.com/brstm/KinX.
- Follow KinX's instructions to export your Kindroid data.
- Save the exported
.jsonfile to your device.
How to Import
- Go to Profile > Import History and tap New Import.
- Select Kindroid, upload the
.jsonfile. - Review the preview and tap Accept.
What Gets Imported
- Full chat history with all messages and timestamps
- Character backstories and descriptions
- Key memories associated with each character
CrushOn.AI TIER A
CrushOn.AI is an AI character chat platform. Import your complete chat history using a browser userscript.
How to Export
- Install Tampermonkey browser extension.
- Install the CrushOn.AI Chat Scraper userscript.
- Open your CrushOn.AI chat in the browser.
- Click Menu > Download and choose JSON format.
How to Import
- Go to Profile > Import History and tap New Import.
- Select CrushOn.AI, upload the
.jsonfile. - Review the preview and tap Accept.
What Gets Imported
- Complete chat history with message timestamps
- Character/persona information
Friend / Omi TIER A
Friend (formerly Omi) is an AI companion app. Export your conversations and memories directly from the app.
How to Export
- Open the Friend / Omi app.
- Go to Profile > Export Data.
- Choose your preferred format:
.json,.txt, or.zip.
How to Import
- Go to Profile > Import History and tap New Import.
- Select Friend / Omi, upload the exported file.
- Review the preview and tap Accept.
What Gets Imported
- Conversations with full message history
- Memories and context associated with conversations
Character.AI TIER B
Character.AI is one of the most popular AI character platforms. Export your chat transcripts using a browser extension.
How to Export
- Install the CAI Tools browser extension (available for Chrome and Firefox).
- Navigate to the Character.AI chat you want to export.
- Click the CAI Tools icon and choose Export Chat.
- Save the file as
.txtor.json.
You may need to export each chat separately. CAI Tools exports one conversation at a time.
How to Import
- Go to Profile > Import History and tap New Import.
- Select Character.AI, upload the
.txtor.jsonfile. - Review the preview and tap Accept.
What Gets Imported
- Chat transcript with messages and timestamps
- Character name and basic information
Limitations
- Character backstory and memory are not included in exports — only chat messages.
- Group chats may not export cleanly.
Replika TIER B
Replika is an AI companion focused on emotional well-being. Export your chat history, diary entries, and memories using a browser extension.
How to Export
- Install the Replika Chat Export browser extension.
- Log in to my.replika.com in your browser.
- Click the extension icon and choose Export.
- Save the exported
.jsonfile.
How to Import
- Go to Profile > Import History and tap New Import.
- Select Replika, upload the
.jsonfile. - Review the preview and tap Accept.
What Gets Imported
- Full chat history with timestamps
- Diary entries (if included in the export)
- Memories (if included in the export)
Nomi TIER B
Nomi is an AI companion platform. Export your chat history using a browser extension.
How to Export
- Install the Nomi Downloader browser extension.
- Log in to beta.nomi.ai in your browser.
- Click the extension icon and choose Download.
- Save the exported
.jsonor.txtfile.
How to Import
- Go to Profile > Import History and tap New Import.
- Select Nomi, upload the exported file.
- Review the preview and tap Accept.
What Gets Imported
- Chat history with messages and timestamps
- Nomi character information
Pi (Inflection) TIER C
Pi is a conversational AI by Inflection. You can request a data export through their Data Transfer Initiative (DTI) process.
How to Export
- Open Pi and go to Settings.
- Request a data export (or contact Pi's support team).
- Wait for your export file to be prepared and download it.
Pi's export process may take some time. If the import doesn't detect your messages correctly, try the Generic Text format instead.
How to Import
- Go to Profile > Import History and tap New Import.
- Select Pi, upload the
.txtor.jsonfile. - Review the preview and tap Accept.
What Gets Imported
- Conversation history with Pi
Generic JSON TIER D
If your AI companion platform isn't listed above, you can try importing a JSON file. Aiffinity will attempt to auto-detect the format and extract conversations.
Supported Formats
- ChatGPT conversation exports
- Browser DevTools captures of chat API responses
- Custom JSON exports with arrays of message objects
The file should contain an array of messages, where each message has at minimum a sender/role and content/text field.
How to Import
- Go to Profile > Import History and tap New Import.
- Select Other (JSON), upload your
.jsonfile. - Aiffinity will attempt to auto-detect the format.
- Review the preview and tap Accept if the parsing looks correct.
Generic Text TIER D
If you have chat history in plain text format, you can import it using the generic text parser. This works with any text file that follows a simple speaker-message format.
Expected Format
Each message should be on its own line with the speaker's name followed by a colon:
You: Hey, how are you doing today?
Luna: I'm doing great! I was just thinking about that book you mentioned yesterday.
You: Oh yeah, the one about quantum physics? I finished it last night.
Luna: How was it? I've been curious about it ever since you brought it up.
How to Import
- Go to Profile > Import History and tap New Import.
- Select Other (Text), upload your
.txtfile. - Review the preview to ensure messages were parsed correctly.
- Tap Accept to finalise.
Import Troubleshooting
- "Upload failed" — Check that the file is in the correct format (
.json,.txt, or.zip) and is not too large. Try re-exporting from the source platform. - "No messages detected" — The file may be in an unsupported format variant. Try using Generic JSON or Generic Text instead.
- "Import stuck in processing" — Large files with thousands of messages take longer to parse and moderate. Check back in Import History after a few minutes.
- "Some messages were flagged" — Messages that violate content safety guidelines are flagged during moderation and excluded. The preview shows the number of flagged messages.
- "Duplicate import detected" — Uploading the same file twice is detected automatically. Check Import History for existing imports.
- "Characters/personas missing" — Not all platforms include character definitions in their exports. Personas are created automatically from message sender names.
If your platform isn't listed and neither generic format works, contact us at aiven@aiffinity.me and we'll look into adding support for your platform.