Evergreen Documentation

Complete guide to your local-first personal CRM

Getting Started

Evergreen is a fast, private, AI-native personal CRM designed for Apple devices. It helps you manage your professional and personal relationships with powerful organization tools while keeping your data under your control with local-first storage and optional iCloud sync.

First Launch

When you first open Evergreen, you'll see an empty contacts table. The app stores your data locally with optional iCloud sync for seamless access across your Mac and iPhone. No setup required—just start adding contacts.

Core Features

Contacts Table

The main interface shows all your contacts in an information-dense table with these columns:

  • Name - Full name with quick edit capability
  • Organization - Company or group affiliation
  • Title - Job title or role
  • Email - Primary email address
  • Tags - Organizing labels (investor, colleague, family, etc.)
  • Location - City or region
  • Last Interaction - When you last connected
  • Next Action - Planned follow-up or reminder
  • Notes - Rich markdown notes preview

The table supports virtualized scrolling for smooth performance with thousands of contacts, multi-column sorting, resizable columns, and state persistence.

Global Search (⌘K)

Instantly search across all contact fields with powerful token-based filtering:

tag:investor

Filter by specific tags

org:acme

Find contacts by organization

email:@acme.ai

Filter by email domain

city:atlanta

Filter by location

touched:<30d

Recently contacted people

has:notes

Contacts with notes attached

Detail Pane

Select any contact to view detailed information:

  • Profile Editing - Inline field editing with autosave
  • Markdown Notes - Rich text notes with autosave and revision tracking
  • Interactions Timeline - Log meetings, calls, emails, and DMs
  • Next Actions - Set reminders with optional due dates

Data Sync & Export

iCloud Sync

Evergreen uses CloudKit to optionally sync your contacts across all your Apple devices:

  • Automatic Sync - Changes sync seamlessly between Mac and iPhone
  • Offline Support - Full functionality without internet connection
  • Privacy-First - Data encrypted in transit and at rest in iCloud
  • User Control - Toggle sync on/off anytime in preferences

Data Export

Export your entire contact database anytime:

  • SQLite Export - Full database backup for complete portability
  • JSON Export - Machine-readable format for migrations
  • CSV Export - Import into spreadsheets or other CRMs
  • No Lock-in - Your data is always yours to take wherever you need

AI Integration (MCP)

Evergreen is built for the age of AI agents. Through the Model Context Protocol (MCP), AI assistants like Claude Desktop can read and write directly to your contacts database.

Setup with Claude Desktop

Add this configuration to your Claude Desktop config file:

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

All AI operations are logged with full attribution in your activity history, so you always know what changes were made and by which assistant.

Available AI Operations

  • Search & Read - Find contacts and view details
  • Create & Update - Add new contacts or modify existing ones
  • Log Interactions - Record meetings, calls, and conversations
  • Activity Review - View recent changes and interactions

Privacy & Security

Local-First Storage

Your contact data is stored locally on your device with optional iCloud sync. You maintain full control with no vendor lock-in, no external servers beyond iCloud, and no telemetry or tracking.

Data Storage

Evergreen uses a local-first approach:

  • Local Cache - Fast local access for offline use
  • iCloud Sync - Optional CloudKit sync for multi-device access
  • Export Anytime - Download full SQLite database whenever needed

No Account Required

Evergreen works immediately without any login, registration, or account creation. Your data belongs to you.

AI Access Control

AI agents can only access your database when the MCP server is running locally on your machine. They cannot access your data remotely or when the app is closed.

Data Management

Import & Export

Evergreen supports importing and exporting your contacts data in JSON format for backup or migration purposes.

Backup

Since all data is stored in a single SQLite file, backing up is as simple as copying the database file to your preferred backup location.

Tags & Organization

Use tags to organize your contacts into meaningful groups. Common tag strategies include:

  • Relationship type - colleague, client, friend, family
  • Industry - tech, finance, healthcare, education
  • Context - investor, mentor, collaborator, customer
  • Priority - vip, regular, archive

Tips & Best Practices

Effective Contact Management

  • Add next actions immediately after meetings to maintain momentum
  • Use consistent tagging schemes for better organization
  • Log interactions promptly while details are fresh
  • Review and update contact information regularly
  • Use the search tokens to quickly find specific groups

AI Assistant Integration

  • Train your AI assistant on your tagging conventions
  • Use natural language to describe contact updates
  • Let AI help you identify patterns in your networking
  • Review AI-generated entries for accuracy