
ppl - Personal CRM for AI Agents
io.github.dbhurleyv1.2.0Updated Oct 3, 2026
Personal CRM operated by AI agents. Read relationship context before acting, write back after.
Overview
A hosted personal CRM that lets an AI assistant read relationship context and log contacts, notes, tasks, and interactions.
- What it does
- ppl is a hosted personal CRM built to be operated by an AI agent, with the agent acting as the intelligence layer and ppl as the memory and data layer. It exposes about 80 tools covering daily briefings, semantic search, person digests, suggested actions, and interaction logging. It also provides full create, read, update, and delete operations for contacts, notes, tasks, reminders, calls, gifts, journal entries, addresses, relationships, places, debts, documents, and life events.
- When to use it
- Worth adding when you want an assistant to keep a personal relationship record: look up context about a person before drafting a message or planning a call, then write back what happened. Useful for people who track many contacts and want briefings, digests, and suggested follow-ups.
- Requirements
- A remote MCP endpoint at ppl.gift over Streamable HTTP. Authentication uses a Bearer token, described as a per-user API token obtained from ppl.gift settings. No local runtime or package is needed.
Installation
In SourceWeft
- Open ppl - Personal CRM for AI Agents in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Other MCP clients
Add this to your client's mcpServers config.
{
"mcpServers": {
"ppl": {
"type": "http",
"url": "https://ppl.gift/mcp"
}
}
}README
ppl
The personal CRM for AI agents.
ppl is a personal CRM designed to be operated by AI agents. Your AI is the intelligence layer. ppl is the memory and data layer. The agent reads relationship context before acting, and writes back after.
The hosted service runs at ppl.gift. This repo holds the public agent interface: the MCP server contract, integration docs, and examples. The application itself is private.
Connect your agent
ppl exposes a Model Context Protocol server at:
Transport: Streamable HTTP. Auth: Bearer token (per-user API token from ppl.gift settings).
80 tools covering: daily briefings, semantic search, person digests, suggested actions, interaction logging, and full CRUD for contacts, notes, tasks, reminders, calls, gifts, journal entries, addresses, relationships, places, debts, documents, and life events.
See docs/agents.md for the full integration guide.
Examples
- examples/python — minimal MCP client in Python
- examples/node — minimal MCP client in Node.js
Registry
server.json is the MCP registry manifest for this server.
License
MIT. See LICENSE.
Source: README.md at commit de5c33d
Tools
0Version history
1- v1.2.0LatestOct 3, 2026