Skip to main content
Glama

Build AI assistants on your own documents and put them wherever work happens: web, WhatsApp, email, Outlook, Nextcloud and ownCloud. Mix local models with the best cloud AI, see what every answer costs, and decide what the AI is allowed to do – open source, on your server or ours.

Run it in up to five minutes  ·  Try it hosted  ·  Docs  ·  Discord

Latest release GitHub stars Discord

Self-hosting is free. The hosted version opens with a paid plan or an invitation code – ask us at team@synaplan.com.


Why Synaplan

  • Own your channels. One assistant answers on your website, in WhatsApp, by email, in Outlook and inside Nextcloud and ownCloud – with the same knowledge and the same rules everywhere.

  • Own your models. Hundreds of models from OpenAI, Anthropic, Google, Mistral, sovereign EU providers or locally via Ollama. Mix them per task: sensitive work stays local, everything else gets the best model for the job.

  • Own your costs. Every answer shows its model and price. A planner splits bigger requests into steps and spends the expensive model only where it matters.

  • Own the decisions. Actions like sending mail or creating tickets wait for your approval, and every step is logged.

  • Own the stack. On-prem, EU cloud or fully air-gapped. No training on your data, no forced telemetry, no feature paywall: self-hosted Synaplan is the same software as our cloud, under Apache-2.0.

Running in production at Megaherz Yoga · SANI Pflegedienst · National Secure Cloud · PlateArt


Related MCP server: laravel-simple-rag

Quickstart

You need: Docker with Compose v2 and 8 GB of RAM.

git clone https://github.com/metadist/synaplan.git
cd synaplan
make up

Open http://localhost:5173, log in as admin@synaplan.com / admin123 and say hello. Your first message starts the Synaplan Demo – no API key needed (40 messages a day for 14 days, how it works). When you're ready, add your own key (free: Groq) or run local models with Ollama.

The first start downloads everything and takes 5–15 minutes. After that, Synaplan starts in seconds.

IMPORTANT

These logins are for trying Synaplan on your own machine. On a server, use theinstaller – it creates its own admin password.


Install it your way

Where

How

Guide

Your machine

make up – the quickstart above

Quickstart

Published image, no git

One compose.yaml, then docker compose up -d

Published image

Docker GUI

Portainer, Dockge, Synology: paste the compose file as a stack

Docker GUI

Closed network

No route to the internet, HTTPS on your LAN address

Closed network

Linux server

The installer pins a release, generates secrets and runs a smoke test

On a server

Kubernetes

Helm charts for clusters

synaplan-charts

One click

RepoCloud · Elestio

–

A Linux server in one line:

curl -fsSL https://raw.githubusercontent.com/metadist/synaplan/main/install.sh | \
  bash -s -- --mode server --domain https://ai.example.com

Public sector & sovereign cloud (EU/CH): synaplan.eu covers openDesk, Nextcloud and OpenCloud deployments, on-premises or in an EU cloud.


How it compares

People usually arrive comparing Synaplan with a chat window or an app builder. This is what each project is for. It is not a scoreboard.

Synaplan

Open WebUI

LibreChat

Dify

What it is

A team platform: chat, your files as knowledge, a site widget, and the same assistant on WhatsApp and email

A chat interface for local and cloud models

A chat app for many providers

A builder for AI apps and workflows

First run

Several containers, about 4 GB

One container

A Compose stack

A Compose stack, and a hosted cloud

Cost of an answer

Shown on the answer

Not on the answer

Not on the answer

In the builder's usage logs, not on the chat answer

Same assistant on your site, WhatsApp and email

Yes

No

No

Site widget yes. WhatsApp and email are not built in

If you only want a chat window, Open WebUI or LibreChat gets you there faster.


Take the tour

A tour through Synaplan: chat with live cost tracking, one-key provider setup, per-task model choice, document search, media generation, the embeddable chat widget and white-label branding


One AI, everywhere you work

The same assistant, the same knowledge, the same model policy – on every channel your team and your customers already use.

Surface

What it does

Get it

Web app

Full chat and admin UI, light and dark, five languages

This repo

Mobile apps

Chat, documents and voice on iPhone and Android – on web.synaplan.com or your own server

App Store · Google Play

Outlook add-in

Find and process mail inside Outlook (Web, new & classic, Mac) without sending it anywhere

Synamail

Chat widget

Your assistant on any website with one snippet, human takeover included

Widget guide

WhatsApp & email

The AI answers on the channel the question came in on

WhatsApp · Email

Nextcloud, ownCloud & OpenCloud

Use your assistants inside your file cloud, with its files as knowledge – your file store stays in charge

Nextcloud · ownCloud · OpenCloud

Synaplan Desktop

Pair a computer and run skills on it (no installer yet – build from source)

synaplan-desktop

MCP & Claude Code

Your knowledge and memories as MCP tools, plus an Anthropic-compatible endpoint

MCP guide

Connects to Microsoft 365 · Dropbox · Nextcloud / ownCloud / WebDAV · CalDAV · IMAP · Jira & Confluence · your own MCP servers – how to connect


Under the hood

  • Stack: Symfony (PHP) backend, Vue frontend, MariaDB VECTOR or Qdrant for document search, Redis, Docker.

  • Lean core: app, database and Redis. Local AI, office files, web search, voice and more are building blocks you switch on when you need them.

  • Open by design: OpenAPI REST API, MCP server and client, an Anthropic-compatible /v1/messages endpoint and a plugin system – extend Synaplan without forking it.

Full feature list, every AI provider, all building blocks and developer commands: Platform reference.


Troubleshooting

Problem

What to do

"Port already in use" on start

A port Synaplan needs is taken – see Port conflicts

Containers stop right after start

Give Docker at least 8 GB of RAM, then check docker compose logs -f backend

Chat gives no answers

Use the Synaplan Demo, paste one provider key, or add the local-ai profile – see the quickstart

First start seems stuck

The first start downloads all images and takes 5–15 minutes. docker compose logs -f startup-notes shows where it is

Anything else

Ask in Discord or open a GitHub issue


Learn more


Help shape what's next

We build Synaplan in the open. Tell us what you'd use it for, vote on ideas or show what you built in Discussions – we read everything.

  • 💬 Discord – the fastest place for self-hosting and configuration questions

  • 🐛 Issues – bugs and feature requests

  • 🙌 Contributing – how to get your first pull request merged (AGENTS.md is the guide for coding agents)

  • 🔒 Security policy – report a vulnerability privately


License

Apache-2.0 · Built in Düsseldorf by metadist · Member of the Open Source Business Alliance

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Self-hosted semantic memory for AI agents. Save worklogs, decisions, and notes via MCP, then recall them across sessions by meaning rather than keyword. Backed by Postgres + pgvector with local embeddings (multilingual-e5-base).
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Self-hosted knowledge manager and MCP server that lets you organize snippets, questions, and documents via a web UI and exposes them to AI assistants for reading and writing.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Universal MCP server providing adaptive semantic memory for AI agents, supporting document ingestion, semantic search, chat persistence, cross-project linking, and cloud storage overflow.
      49 PyPI
      3
      GPL 3.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides AI agents and teams with self-hosted adaptive memory, combining hybrid search and a self-improving neural memory graph to enable precise recall and serendipitous discovery across MCP-compatible clients.
      13
      Apache 2.0