ppl - Personal CRM for AI Agents
Personal CRM operated by AI agents. Read relationship context before acting, write back after.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http ppl-personal-crm-for-ai-agents 'https://ppl.gift/mcp'
{
"mcpServers": {
"ppl-personal-crm-for-ai-agents": {
"type": "http",
"url": "https://ppl.gift/mcp"
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
ppl
Relational memory for you and your AI.
ppl is a personal CRM for you and the AI assistants you choose. Keep contacts, conversation notes, birthdays and follow-ups together. Work in the browser or authorize an assistant to use the same records.
Read about ppl, choosing a personal CRM, or importing your contacts.
The guides and free tools cover client setup, product comparisons and contact migration. Start with your client’s Claude, ChatGPT, Cursor, or VS Code guide. Before importing, the local CSV checker can flag common file issues without uploading your contacts. Writers and directory maintainers can use the press kit for current product facts, the original logo and public screenshots.
Developer home: ppl-crm.github.io. Try the fictional relationship-memory demo without connecting an account.
Connect your AI
Hosted MCP server: https://withppl.com/mcp
The hosted service is available now. A self-hosted version is coming soon. Your agent connects over Streamable HTTP with a Bearer token.
Start with your client
Use the connection guide for client setup or the developer guide for authentication, permissions, starter recipes and recovery. New users can create an account during connection and verify email ownership. Some clients require a separate configuration step; available features can depend on account plans and administrator settings.
Codex CLI
Codex supports Streamable HTTP MCP servers with OAuth and Dynamic Client Registration. Add ppl, then sign in:
codex mcp add ppl --url https://withppl.com/mcp
codex mcp login ppl
Or add it to ~/.codex/config.toml and run codex mcp login ppl:
[mcp_servers.ppl]
url = "https://withppl.com/mcp"
The login opens ppl in your browser to approve access. New to ppl? Create a free account (free beta, up to 1,000 contacts). Run codex mcp list to confirm the server, or /mcp inside the Codex TUI. See the Codex MCP docs.
Agent connection flow
POST https://withppl.com/api/agent/connect/requestwith{"client_name": "Your agent"}- Show the human the
approve_url. They sign in or create an account, verify email ownership and review the requested permissions. - Poll the returned
poll_urlconservatively until approved and save the one-timeapi_tokenin a protected credential store. Stop on denial or expiration. - Use the token with the MCP server or REST API.
MCP clients that support OAuth (Claude, ChatGPT, and others) can connect with standard OAuth 2.0: dynamic client registration, PKCE, and refresh tokens. See docs/oauth.md.
Machine-readable: ppl.json, llms.txt, and the OpenAPI spec for the REST API.
MCP registry
Registered as io.github.ppl-crm/ppl in the official MCP registry. See server.json.
Examples
- Python briefing examples - a dependency-free REST client and an MCP SDK client
- Node MCP client - connect with the MCP TypeScript SDK
- ppl-memory PyPI package - LangGraph, CrewAI, and AutoGen adapters
Docs
- Agent integration guide - task-scoped workflows, tools, and patterns
- OAuth for MCP clients - Dynamic Client Registration flow
License
MIT. See LICENSE.
Questions fréquentes
Qu'est-ce que ppl - Personal CRM for AI Agents ?
Personal CRM operated by AI agents. Read relationship context before acting, write back after.
Comment installer ppl - Personal CRM for AI Agents ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http ppl-personal-crm-for-ai-agents 'https://ppl.gift/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour ppl - Personal CRM for AI Agents ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
ppl - Personal CRM for AI Agents est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient ppl - Personal CRM for AI Agents ?
Il est publié par ppl-crm. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.