Skip to content
markupp
Open source · AGPL v3 · MCP for your agents

The knowledge base that organizes itself.

Write in plain markdown. markupp links, groups and indexes every note on the server, so you and your AI agents find what you mean, not only what you typed.

Start for free Read the docs

Self-host in one command

$ docker compose up

A towering wave with claw-like foam curls over three boats, with Mount Fuji small in the distance.

markupp · free for one person

The Great Wave off Kanagawa, Thirty-six Views of Mount Fuji, c. 1831Katsushika Hokusai, public domain

markupp / product

product/pricing-decision.md

# Pricing decision

We charge per workspace, never per agent.
Readers and AI agents are always free.

- Pro at $8, Max at $39 per team
- Context: [[Customer interviews]]
- Owner sync: [[Weekly sync]]
graph linked inferred
Pricing decisionPlansPaymentsCustomer interviewsMarket notesCompetitorsWeekly syncRoadmapHiring

The name

Two ways to read the name.

markdown + up
Your notes are plain markdown. The up is the server: always on, doing the filing. Write a .md file and save it; markupp serves it back indexed, linked and grouped.
omakase
At a sushi counter, omakase means “I leave it up to you”: you trust the chef with the menu. Omarchy borrowed the idea for Arch Linux. In markupp you leave the filing to us. No folders to design, no tags to maintain: the server stores every note, links it to the related ones, groups them into communities and keeps it all searchable, for you and your agents.
Read Omakase Computing →

お任せYou bring the ingredients. We run the kitchen.

A crowded ferry crosses the Sumida river at sunset, the long Ryogoku bridge and Mount Fuji behind it.
Sunset across the Ryogoku Bridge from the Bank of the Sumida River at Onmayagashi, Thirty-six Views of Mount Fuji, c. 1831Katsushika Hokusai, public domain

Connects to the agents you already use

  • Claude Code
  • Codex
  • Cursor
  • VS Code
  • Gemini CLI
  • Claude Desktop
  • Any MCP client
A fisherman on a rock casts lines into a rough river while Mount Fuji rises behind the mist.
Kajikazawa in Kai Province, Thirty-six Views of Mount Fuji, c. 1831Katsushika Hokusai, public domain

Why markupp

Stop filing notes. Start finding answers.

Most note apps make you the librarian. markupp moves that work to the server, so every client, human or agent, sees the same organized knowledge.

Carpenters work on the huge roof of a temple while a kite flies and Mount Fuji rises beyond the clouds.
Asakusa Honganji Temple in the Eastern Capital, Thirty-six Views of Mount Fuji, c. 1831Katsushika Hokusai, public domain

Ecosystem

One server, every client.

The server does the organizing, so every client sees the same notes, links and communities. Use the web panel, your terminal, your editor or your AI agents, all against the same API.

browser

Web panel

Write and read notes side by side, search by meaning, and explore the graph and the communities the server found.

Source on GitHub
editor
The markupp panel with a markdown note in the editor and its rendered preview side by side.
graph
The graph view of the panel, with notes as colored nodes grouped into communities.
search
The panel search listing notes that match a question, with the matching passage under each one.
links
The links of a note in the panel: outgoing links, backlinks and unlinked mentions.

agents

MCP server

Connect Claude Code, Codex, Cursor or any MCP client with OAuth. Agents search, read and write notes with your permissions.

Source on GitHub
connect
The panel page that shows the command to connect Claude Code to the markupp MCP server.
public mcp
A terminal calling the public MCP tools of a published vault and printing the notes it returned.

terminal

mu

The command line client. A K9s-style TUI for people, and plain text, JSON or NDJSON subcommands for scripts and agents.

Source on GitHub
mu tui
The mu terminal interface listing the notes of a vault in a sortable table.
mu notes search
A terminal running mu vaults list and mu notes search with their text output.

editor

Obsidian plugin

Keep writing in Obsidian. Fetch, pull, push and sync your vault with the markupp server, with conflict detection.

Source on GitHub
sync panel
Obsidian with a note open and the markupp control panel listing the notes to push to the server.
Travelers and packhorses walk a mountain road above the rushing Minobu river, Mount Fuji behind the hills.
The Back of Fuji from the Minobu River, Thirty-six Views of Mount Fuji, c. 1831Katsushika Hokusai, public domain

Agents via MCP

Your agents remember what your team knows.

markupp is AI first. Any operation available to a person is available to an agent through the same interface, so your coding assistant can look up a decision before it writes code and record a new one after.

  • Remote MCP server with OAuth, one command to connect
  • Search, read, create and edit notes with your permissions
  • Readers and agents never count as paid seats
terminal

$ claude mcp add --transport http markupp https://markupp.k8s.sj.ifsc.edu.br/mcp

Added HTTP MCP server markupp.

> What did we decide about pricing for agents?

search_notes(query: "pricing for agents")

read_note("product/pricing-decision.md")

You charge per workspace and never per agent: readers and AI agents are always free. Source: [[Pricing decision]]

Travelers cross a small wooden bridge over a stream on a country road, with Mount Fuji behind.
Nakahara in Sagami Province, Thirty-six Views of Mount Fuji, c. 1831Katsushika Hokusai, public domain

# clone and run the whole stack

$ git clone https://github.com/markupp-labs/markupp

$ cd markupp

$ docker compose up

server on localhost:8080, panel on localhost:3000

Self-host

Own every byte of your knowledge.

Use our cloud or run markupp on your own infrastructure. Same features, same agents, same markdown.

Your server, your data
Postgres with row level security per workspace. Nothing leaves your network.
Runs anywhere
Docker Compose on a laptop, or the Kubernetes component for production.
Open source
AGPL v3. Read the code, audit it, contribute back.

Start now

Give your notes a brain.

Start free in the cloud, or self-host it today. Your notes stay plain markdown either way.

Start for free See pricing
A great wave breaks into a spray of birds flying toward Mount Fuji, in a colored edition.
The Big Wave, One Hundred Views of Mount Fuji, 1835Katsushika Hokusai, public domain