Conatus

nojusmorkunas56stars

A self-hosted task manager for projects, recurring work, reminders, collaboration and automation. Inspired by Todoist.

1# Conatus

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: AGPL-3.0
Last checked: 2026-10-27

Stars: 56
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Conatus?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Conatus need an API key?

No required environment variable is listed on this record.

What transport does Conatus use?

Conatus runs locally over stdio.

When was Conatus last checked?

Last checked 2026-10-27. A self-hosted task manager for projects, recurring work, reminders, collaboration and automation. Inspired by Todoist.

From the publisher

Documentation

1. Get the Compose file and environment template

mkdir conatus
cd conatus

curl -O https://raw.githubusercontent.com/nojusmorkunas/conatus/main/docker-compose.yml
curl -o .env https://raw.githubusercontent.com/nojusmorkunas/conatus/main/.env.example

2. Edit your credentials

Open .env and replace every replace-with-... value with your own:

# latest follows the newest stable release. Pin an exact version without the
# leading "v" to upgrade only when you choose.
CONATUS_VERSION=latest
CONATUS_PORT=4399

POSTGRES_USER=app
POSTGRES_PASSWORD=replace-with-a-long-random-password
POSTGRES_DB=app

AUTH_SECRET=replace-with-a-long-random-secret

S3_ACCESS_KEY=replace-with-a-random-access-key
S3_SECRET_KEY=replace-with-a-long-random-secret-key

# Optional: creates the first administrator on an empty database.
CONATUS_ADMIN_USERNAME=admin
CONATUS_ADMIN_PASSWORD=replace-with-a-long-random-password

If you use a domain or reverse proxy, also set AUTH_URL and PUBLIC_BASE_URL to the external HTTPS address. The reverse proxy guide has Caddy and nginx configs.

To sign in through Keycloak, Authentik or another OpenID Connect provider, set the AUTH_OIDC_* values described in .env.example.

3. Start Conatus

docker compose up -d

Docker Compose pulls the Conatus application, operations, PostgreSQL and Silo images. Silo stores attachments and is a maintained fork of MinIO. Open http://localhost:4399 and sign in with the administrator credentials from .env, then remove CONATUS_ADMIN_USERNAME and CONATUS_ADMIN_PASSWORD from .env.

Upgrading

Set CONATUS_VERSION to the new release, then run:

docker compose pull
docker compose up -d

Migrations run automatically before the application starts, and you can upgrade from any earlier published release. Back up the database first, since some migrations need a restore to roll back. See the upgrade guide.

Documentation

The full documentation is at useconatus.com:

Environment variables
Backups and restore
Users, registration and rate limits
REST API. The OpenAPI 3.1 description is at /api/v1/openapi.json
Webhooks
MCP server
Migrating from Todoist

Contributing

Questions and ideas go in Discussions and bugs in Issues. See CONTRIBUTING.md for local setup, database migrations and the checks a pull request needs to pass.

License

AGPL-3.0-or-later. See LICENSE.

Star history

Conatus

nojusmorkunas56stars

A self-hosted task manager for projects, recurring work, reminders, collaboration and automation. Inspired by Todoist.

Databases Devops Collaboration

Install Run on PlugMCP

GitHub Website

Run on PlugMCP

1# Conatus

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: AGPL-3.0
Last checked: 2026-10-27

Stars: 56
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Conatus?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Conatus need an API key?

No required environment variable is listed on this record.

What transport does Conatus use?

Conatus runs locally over stdio.

When was Conatus last checked?

Last checked 2026-10-27. A self-hosted task manager for projects, recurring work, reminders, collaboration and automation. Inspired by Todoist.

From the publisher

Documentation

1. Get the Compose file and environment template

mkdir conatus
cd conatus

curl -O https://raw.githubusercontent.com/nojusmorkunas/conatus/main/docker-compose.yml
curl -o .env https://raw.githubusercontent.com/nojusmorkunas/conatus/main/.env.example

2. Edit your credentials

Open .env and replace every replace-with-... value with your own:

# latest follows the newest stable release. Pin an exact version without the
# leading "v" to upgrade only when you choose.
CONATUS_VERSION=latest
CONATUS_PORT=4399

POSTGRES_USER=app
POSTGRES_PASSWORD=replace-with-a-long-random-password
POSTGRES_DB=app

AUTH_SECRET=replace-with-a-long-random-secret

S3_ACCESS_KEY=replace-with-a-random-access-key
S3_SECRET_KEY=replace-with-a-long-random-secret-key

# Optional: creates the first administrator on an empty database.
CONATUS_ADMIN_USERNAME=admin
CONATUS_ADMIN_PASSWORD=replace-with-a-long-random-password

If you use a domain or reverse proxy, also set AUTH_URL and PUBLIC_BASE_URL to the external HTTPS address. The reverse proxy guide has Caddy and nginx configs.

To sign in through Keycloak, Authentik or another OpenID Connect provider, set the AUTH_OIDC_* values described in .env.example.

3. Start Conatus

docker compose up -d

Upgrading

Set CONATUS_VERSION to the new release, then run:

docker compose pull
docker compose up -d

Documentation

The full documentation is at useconatus.com:

Environment variables
Backups and restore
Users, registration and rate limits
REST API. The OpenAPI 3.1 description is at /api/v1/openapi.json
Webhooks
MCP server
Migrating from Todoist

Contributing

Questions and ideas go in Discussions and bugs in Issues. See CONTRIBUTING.md for local setup, database migrations and the checks a pull request needs to pass.

License

AGPL-3.0-or-later. See LICENSE.