# Markdown Notes Mcp

> MCP server that enables AI assistants to manage Markdown notes through the Model Context Protocol.

- **Type:** MCP server
- **Install:** `agentstack add mcp-ateska-markdown-notes-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ateska](https://agentstack.voostack.com/s/ateska)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** BSD-3-Clause
- **Upstream author:** [ateska](https://github.com/ateska)
- **Source:** https://github.com/ateska/markdown-notes-mcp

## Install

```sh
agentstack add mcp-ateska-markdown-notes-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# markdown-notes-mcp

[](LICENSE)

MCP server that enables AI assistants to manage Markdown notes through the Model Context Protocol.
Built on [ASAB](https://github.com/TeskaLabs/asab) framework with multi-tenant support and image upload capabilities.
This project is also a demo how to write MCP servers using ASAB framework and Python.

## Overview

`markdown-notes-mcp` is a [MCP](https://modelcontextprotocol.io/docs/getting-started/intro) (Model Context Protocol) server implementation that provides AI assistants with tools to create, read, update, delete, and organize Markdown notes.
The server exposes a standardized MCP interface, allowing AI applications to interact with a local or remote Markdown notes repository.
This MCP server ofers _Streamable HTTP transport_, it DOESN'T provide _Stdio transport_ (yet).

The cool part is that you can interconnect more LLMs to work colaboratively on Markdown notes; ie. one is the writer and second is the opponent.

The Model Context Protocol (MCP) is a standardized protocol for connecting AI applications to external data sources and tools. This implementation leverages ASAB's microservice framework (`aiohttp` internally), providing unified configuration, logging, metrics, and HTTP server capabilities.

## Features

- **Full CRUD Operations**: Create, read, update, and delete Markdown notes
- **Directory Support**: Organize notes in nested directory structures
- **Image Upload**: WIP Upload and manage images (JPG, PNG, GIF) alongside notes
- **Multi-Tenant Support**: Isolated note storage per tenant
- **Resource Templates**: Access notes via URI templates (`note://{path}` and `img://{path}`)
- **MCP Protocol Compliance**: Full support for MCP protocol specification
- **Built on ASAB**: Production-ready microservice framework with async/await support
- **Security**: Path normalization prevents directory traversal attacks

## Quick Start

### Installation into a Docker

```bash
git clone 
docker build -t markdown-notes-mcp .
```

### Running the Server

```bash
docker run -it -v$(pwd)/etc:/conf:ro -p 8898:8898 --rm markdown-notes-mcp
```

### Configuration

Create a configuration file (e.g., `etc/markdown-notes-mcp.conf`):

```ini
[general]
notes = notes

[web]
listen = 8898

[tenants]
ids = tenant1,tenant2
```

- `notes`: Directory path where Markdown notes will be stored (default: `notes`), the first subdirectory is a tenant.
- `listen`: HTTP server listen address (default: `8898`)
- `ids`: Comma-separated list of tenant IDs for multi-tenant support, at least one tenant must be provided

## License

This project is licensed under the BSD 3-Clause License - see the [LICENSE](LICENSE) file for details.

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## References

- [ASAB Framework](https://github.com/TeskaLabs/asab) - The underlying microservice framework
- [asab-mcp](https://github.com/TeskaLabs/asab-mcp) - MCP server implementation for ASAB
- [Model Context Protocol Specification](https://modelcontextprotocol.io/) - Official MCP specification

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ateska](https://github.com/ateska)
- **Source:** [ateska/markdown-notes-mcp](https://github.com/ateska/markdown-notes-mcp)
- **License:** BSD-3-Clause

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-ateska-markdown-notes-mcp
- Seller: https://agentstack.voostack.com/s/ateska
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.