mdshare — Free Markdown Sharing with MCP

Name: mdshare — Free Markdown Sharing with MCP
Author: urbanmorph

Local

github.com/urbanmorphProductivity8Updated 3d ago

Repository

About mdshare — Free Markdown Sharing with MCP

mdshare is a Markdown sharing and collaboration service with an editor, permissioned links, and inline comments. Its MCP server can upload local Markdown files directly, while plugins bring sharing into VS Code, Obsidian, and supported AI tools.

Key features

01Share documents with four permission levels
02Edit Markdown with a WYSIWYG editor
03Add and resolve inline comments
04Collaborate with real-time sync and presence
05Share local files through MCP and editor plugins

Use cases

01Share notes with view or edit access
02Collect feedback on specific text passages
03Collaborate on Markdown documents in real time
04Upload local notes from an MCP-compatible tool

MCP support

The MCP server runs with `npx mdshare-mcp` and reads Markdown files directly from disk for upload. It is also wrapped by the Claude Code and Cursor plugins.

#markdown #collaboration #sharing #free #mcp #productivity

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "mdshare": {
      "command": "npx",
      "args": [
        "-y",
        "mdshare-mcp"
      ]
    }
  }
}

Run commandnpx -y mdshare-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npmmdshare-mcp1.5.0stdio

Tools

Saved tool list · updated 3w ago

Parameter	Type	Required	Description
file_path	string	No	Absolute path to a local markdown file. PREFERRED for any file already on disk — bypasses inline content transmission entirely.
content	string	No	Inline markdown content. Only use this for short snippets composed in the conversation. For files on disk, use file_path instead.
share_permission	enum	No	Permission level for the share link returned to the user. Default 'comment' — recipients can read and comment. Use 'view' for read-only, 'edit' for full write access.view \| comment \| edit

Details

From the project README

mdshare

Share markdown instantly. Free. No login required.

mdshare.live | API Docs | VS Code | Obsidian

mdshare editor

Quick Start

Paste markdown at mdshare.live, start from a blank page, or upload via curl:

curl -X POST https://mdshare.live/api/documents \
  -H "Content-Type: text/markdown" \
  --data-binary @your-file.md

You get back an admin URL. Share it, or generate links with different permissions.

Full API documentation

Features

Four permission levels -- Admin, Edit, Comment, View -- each with its own shareable link
WYSIWYG editor -- formatting toolbar, tables, code blocks, keyboard shortcuts
Inline comments -- anchor comments to specific text, reply, and resolve
Real-time sync -- WebSocket collaboration, live presence indicators
Link management -- revoke links instantly, optional expiry, 50-link cap per document
VS Code & Obsidian plugins -- share markdown directly from your editor
API & MCP -- REST API + MCP server for Claude, ChatGPT, Gemini, Cursor, and Windsurf

MCP Server

npx mdshare-mcp

Say "upload my-notes.md to mdshare" in any MCP-compatible AI tool. The MCP server reads files directly from disk (no echoing through the conversation), so it's fast even for large markdown files. Setup guide

Claude Code Plugin

/plugin marketplace add urbanmorph/mdshare
/plugin install mdshare@urbanmorph

Wraps the MCP server above with a single skill — Claude reaches for it on phrases like "share this markdown". Setup guide · source

Cursor Plugin

Listed on Cursor Directory — click "Add to Cursor" on the listing page. Same MCP server, same skill as the Claude Code plugin. Source

Obsidian Plugin

Listed in the Obsidian Community Plugins directory — install via Settings → Community Plugins → Browse → search "mdshare". Right-click any .md file in your vault to share it; admin URL is copied to your clipboard. Source

Tech Stack

Component	Technology
Framework	Astro 5
UI	React (as Astro islands)
Hosting	Cloudflare Workers (native)
Database	Cloudflare D1 (SQLite)
Real-time	Cloudflare Durable Objects (WebSocket)
Editor	Tiptap + tiptap-markdown
Styling	Tailwind CSS v4
CI/CD	GitHub Actions

Local Development

git clone https://github.com/urbanmorph/mdshare.git
cd mdshare
npm install

# Create a .dev.vars file with your Cloudflare API token
echo "CLOUDFLARE_API_TOKEN=your_token" > .dev.vars

# Apply local D1 migrations
npx wrangler d1 migrations apply mdshare-db --local

# Start dev server
npm run dev -- -p 3737

Contributing

Issues and PRs welcome. Please open an issue first to discuss significant changes.

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.