Personal CRM. Remember everything about your friends and family.
Failed to load latest commit information.
.circleci ci: auto update staging (#2010) Nov 9, 2018
.github docs: update readme and github issue templates (#1808) Sep 10, 2018
app fix: fix document upload limit (#2017) Nov 11, 2018
bootstrap Add UUID instead of actual ID to identify contacts (#777) Apr 8, 2018
config chore: bump version to 2.10.1 (#2031) Nov 13, 2018
database feat: read changelogs from json file instead of db (#2016) Nov 11, 2018
docs docs: add basic SSL documentation (#1997) Nov 11, 2018
public feat: add ability to see contacts for each tag in the Tags view on th… Nov 13, 2018
resources fix: fix work information not being able to be edited (#2030) Nov 13, 2018
routes feat: vcard services for import/export (#1996) Nov 11, 2018
scripts ci: fix sonar branch for external PR (#1952) Oct 25, 2018
storage test: improve services rules validation (#1986) Nov 2, 2018
tests fix: fix failing cypress tests (#2018) Nov 11, 2018
.dockerignore Added docker for development support + added docker-squash to reduce … May 2, 2018 feat: CardDAV support (#1284) Oct 29, 2018
.env.example feat: add account limit for document upload (#2013) Nov 11, 2018
.gitattributes Yubikey support (#1031) Jul 4, 2018
.gitignore feat: add sentry:release command (#1836) Sep 23, 2018
.sass-lint.yml Migrate to organization Feb 17, 2017
.styleci.yml Refactor how reminders are sent (#1527) Jul 1, 2018
CHANGELOG chore: bump version to 2.10.1 (#2031) Nov 13, 2018 chore: update code of conduct (#1941) Oct 23, 2018 Update installation instructions (#1550) Jul 7, 2018
CONTRIBUTORS docs: documentation for PostgreSQL users and bug fixes (migration wit… Oct 27, 2018
Dockerfile Fix docker version (#1720) Aug 19, 2018 Remove nbsp space use (#1569) Jul 14, 2018
Envoy.blade.php fix: improve fortrabbit deploy file (#1843) Sep 26, 2018
Jenkinsfile chore(ci): support jenkins (#1760) Sep 21, 2018
LICENSE Update LICENSE Jun 7, 2017
Makefile feat: add ability to archive a contact (#1769) Oct 27, 2018
Procfile Add an update command (#997) Apr 7, 2018
app.json fix(command): Cache configuration on Update in production (#1688) Aug 24, 2018
artisan Migrate to organization Feb 17, 2017
composer.json feat: vcard services for import/export (#1996) Nov 11, 2018
composer.lock fix: fix composer lock file (#2022) Nov 11, 2018
crowdin.yml Update crowdin configuration (#1402) May 29, 2018
cypress.json tests: Add end 2 end frontend testing with Cypress (#1403) Aug 16, 2018 feat: CardDAV support (#1284) Oct 29, 2018
docker-compose.yml fix(docker-compose): mount top-level storage dir (#1548) Jul 10, 2018
fortrabbit.yml fix: improve fortrabbit deploy file (#1843) Sep 26, 2018
nginx_app.conf Migrate to organization Feb 17, 2017
package.json feat: add ability to autocomplete tags (#1995) Nov 10, 2018
phpunit.xml feat: vcard services for import/export (#1996) Nov 11, 2018
phpunitpostgres.xml tests: Add end 2 end frontend testing with Cypress (#1403) Aug 16, 2018
psalm.xml chore: remove events table (#1829) Sep 23, 2018 fix: wrong url on LICENSE badge (#1899) Oct 10, 2018
server.php Add style CI (#503) Jul 27, 2017 fix: Update sonar sources and exclusions (#1645) Aug 1, 2018
webpack.mix.js feat(language): support Arabic language and fix a lot of rtl displays ( Aug 25, 2018
yarn.lock feat: add account limit for document upload (#2013) Nov 11, 2018

Personal Relationship Manager

Build Status StyleCI Code coverage Quality gate License

Monica is a great open source personal relationship management system.


Monica is an open-source web application to organize the interactions with your loved ones. We call it a PRM, or Personal Relationship Management. Think of it as a CRM (a popular tool used by sales teams in the corporate world) for your friends or family. This is what it currently looks like:

screenshot of the application

We also have official open source mobile apps but they are extremely basic at this point and not well maintained.


Monica allows people to keep track of everything that's important about their friends and family. Like the activities done with them. When you last called someone. What you talked about. It will help you remember the name and the age of the kids. It can also remind you to call someone you haven't talked to in a while.


  • Add and manage contacts
  • Define relationships between contacts
  • Reminders
  • Auto reminders for birthdays
  • Stay in touch with a contact by sending reminders at a given interval
  • Management of debts
  • Ability to add notes to a contact
  • Ability to indicate how you've met someone
  • Management of activities done with a contact
  • Management of tasks
  • Management of gifts
  • Management of addresses and all the different ways to contact someone
  • Management of contact field types
  • Management of contact pets
  • Basic journal
  • Ability to indicate how the day went
  • Export and import of data
  • Export a contact as vCard
  • Ability to set custom genders
  • Ability to define custom activity types
  • Ability to favorite contacts
  • Track conversations made on social media or SMS
  • Multi users
  • Labels to organize contacts
  • Ability to define what section should appear on the contact sheet
  • Multi currencies
  • Multi languages
  • An API that covers most of the data
  • We also have official mobile apps, also open source

Who is it for?

This project is for people who have hard time remembering details about other people's lives - especially the ones they care about. Yes, you can still use Facebook to achieve this, but you will only be able to see what people do and post, and not add your own notes about them.

We've also received numerous feedback of users who suffer from Asperger's syndrome, alzheimer disease, or simply introverts who use this application on a daily basis.

What Monica isn't

  • Monica is not a social network and never will be. It's not meant to be social. In fact, it's for your eyes only.
  • Monica is not a smart assistant - it won't guess what you want to do. It's actually pretty dumb: it will send you emails only for the things you asked to be reminded of.
  • Monica is not a tool that will scan your data and do nasty things with it. It's your data, your server, do whatever you want with it.

Where does this tool come from?

I originally built this tool to help me in my private life: I've been living away of my own country for a long time now. I want to keep notes and remember the life of my friends in my home country and be able to ask the relevant questions when I email them or talk to them over the phone. Moreover, as a foreigner in my new country, I met a lot of other foreigners - and most come back to their countries. I still want to remember the names or ages of their kids. Call it cheating but considering my poor memory, I call it caring.

After a few months, I decided to open source the project so it would help other people as well.

Get started

There are multiple ways of getting started with Monica.

  1. You can use our hosted-version (this is the simplest way to use the product) on
  2. You can install it on your server: follow installation instructions (here).

Note: while the .com version has a paid plan, there is no limitations on Monica if you install it on a server that you own.


If you want to host it yourself, you need

  • PHP 7.1+ or newer
  • HTTP server with PHP support (eg: Apache, Nginx, Caddy)
  • Composer
  • MySQL

Update your instance

Once the software is installed, you'll need to update it from time to time to have access to the latest features. Read this document to learn how to do it.


Do you want to help? That's awesome. Here are simple things you can do.

As a community

  • Unlike Fight Club, the best way to help is to actually talk about the project as much as you can (blog post, articles, Twitter, Facebook).
  • You can answer questions in the issue tracker to help other community members.
  • You can support financially the project on Patreon or by subscribing to an account.

Contribute as a developer

  • Read our Contribution Guide.
  • Install the developer version locally so you can start contributing instructions.
  • Look for issues labelled bugs if you are looking to have an immediate impact on the project.
  • Look for issues labelled Help wanted These are issues that you can solve relatively easily.
  • Look for issues labelled Good first issue These issues are for people who want to contribute, but try to work on a small feature first.
  • If you are an advanced developer, you can try to tackle issues labelled feature requests. Beware though - they are harder to do and will require a lot of back and forth with the repository administrator in order to make sure we are going to the right direction with the product.

We welcome contributions of all kinds from anyone.

Principles, vision, goals and strategy

We want to use technology in a way that does not harm human relationships, like big social networks can do.


Monica has a few principles.

  • It should help have better relationships.
  • It should be simple to use, simple to contribute to, simple to understand, extremely simple to maintain.
  • It is not a social network and shall never be.
  • It is not and will never be ad-supported.
  • Users are not and will never be tracked.
  • It should be transparent.
  • It should be open-source.
  • It should do one thing (documenting social interactions) extremely well, and nothing more.
  • It should be well documented.


Monica's vision is to help people have more meaningful relationships.


We want to provide a platform that is:

  • really easy to use: we value simplicity over anything else.
  • open-source: we believe everyone should be able to contribute to this tool, and see for themselves that nothing nasty is done behind the scenes that would go against the best interests of the users. We also want to leverage the community to build attractive features and do things that would not be possible otherwise.
  • easy to contribute to: we want to keep the codebase as simple as possible. This has two big advantages: anyone can contribute, and it's easily maintainable on the long run.
  • available everywhere: Monica should be able to run on any desktop OS or mobile phone easily. This will be made possible by making sure the tool is easily installable by anyone who wants to either contribute or host the platform themselves.


We think Monica has to become a platform more than an application, so people can build on it.

Here what we should do in order to realize our vision:

  • (done) Build an API in order to create an ecosystem. The ecosystem is what will make Monica a successful platform.
  • (done) Build importers and exporters of data. We don't want to have any vendor lock-ins. Data is the property of the users and they should be able to do whatever they want with it.
  • Be the central point of contact management, by supporting CardDav protocol.
  • Be the central point of calendar events, by supporting CalDav protocol.
  • (done) Be available on mobile apps, not just a responsive site.
  • (partially done) Build great reports so people can have interesting insights on how they interact with their loved ones.
  • Create a smart recommendation system for gifts. For instance, if my nephew is soon 6 years old in a month, I will be able to receive an email with a list of 5 potential gifts I can offer to a 6 year old boy.
  • Add more ways of being reminded: Telegram, SMS,...
  • Create Chrome extensions to load Monica's data in a sidebar when viewing a contact on Facebook, letting us take additional notes as we see them on Facebook.
  • Add modules that can be activated on demand. One would be for instance, for the people who wants to use Monica for dating purposes (yes, we've received this kind of feedback already).


While it's not the driving force behind this project, it would be great if the tool could generate money, so we could work full time on it and sustain it on the long run. We are a big fan of Sentry, Wordpress and GitLab and we believe this kind of business model is inspiring, where everyone wins.

If you want to have it for free with all the features, run the project yourself on a server you own. However, if you want to support the development of the project, consider taking a Pro account, or support the project on Patreon.

  • On, Monica will be offered in two versions. Note that this can change anytime as we are trying different business models to see if this project can be sustained in the long run:
    • a free plan:
      • 10 contacts
      • Exporters
    • a paid plan:
      • unlimited contacts
      • Advanced features
      • Email reminders
      • Importers
      • People who contribute to the GitHub repository (with a pull request that adds value, that gets merged—not a typo fix, for instance) will also have access to the Paid version for free.
  • There is a Patreon account for those who still want to support the tool. Keep in mind that the best way to support it is to actually talk about it around you.

Note: you can also run it yourself. This is sometimes also called on-premise. Download the code, run it on Heroku, with Docker. The choice is yours.

  • The downloadable version will always be the most complete version - the same offered on the paid plan on .com.
  • This version will be completely free with no strings attached and you will be in complete control.

There is currently not, and will never be, ads on the platform. We will never resell your data on .com. We are like you, and this is why we are on GitHub: we hate big corporations that do not have at heart the best interest at heart for their users, even if they say otherwise. The only way, therefore, to sustain the development of the product is to actually make money in a good-old fashioned way.

Why Open Source?

Why is Monica open source? Is it risky? Will someone steal my code and do a for-profit business that will kill my own business? Why reveal my strategy to the world? This is the kind of questions we've received by email already.

The answer to these questions is simple: yes, you can fork the project and do a competing project, make money out of it (even if the license is not super friendly to achieve that) and I'll never know. But it's ok, I don't mind.

I wanted to open source this project for several reasons:

  • I believe, perhaps naively, that this project can really change people's lives. While I aim to make money out of it, I also want everyone to benefit from it. Open sourcing a project like this will help Monica become much bigger than what I imagine myself. While I strongly believe that the project has to follow the vision I have for it, I need to be humble enough to know that ideas come from everywhere, and people have much better ideas than what I can have.
  • You can't do something great alone. While Monica could become a company and hire a bunch of super smart people to work on it, you can't beat the manpower of an entire community. Open sourcing the product means bugs will be fixed faster, features will be developed faster, and more importantly, developers will be able to contribute to the project that changes either their own lives, or other people's lives.
  • Doing things in a transparent manner, like it's the case when you open source something, lead to formidable things. People respect the project more. You can't hide nasty piece of code. You can't do things behind the back of your users. It's a major driving force that motivates you to keep doing what's right.
  • I believe that once you have created a community of passionate developers around your project, you've won - because developers are very powerful influencers. Developers will create apps around your product, talk about it on forums, and tell about the project to their friends. Cherish the developers - users will follow.


You can support the development of this tool on Patreon. Thanks for your help.



Our team is made of 3 core members:

We are also fortunate to have an amazing community of external developers who help us greatly.

Thank you, open source

Monica use a lot of open source projects and we thank them with all our hearts. We hope that providing Monica as an free, open source project will help other people the same way those softwares have helped us.


Copyright (c) 2016-2018

Licensed under the AGPL License. View license.