@abhishekmcp/notes 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Abhishek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,81 @@
+# @abhishekmcp/notes
+
+An [MCP](https://modelcontextprotocol.io) server for managing local markdown notes. Lets any MCP client (Claude Desktop, Claude Code, Cursor, …) search, read, create, link, and organize notes in a folder on your machine.
+
+## Features
+
+**Tools**
+- `list_notes` — list all notes, newest first
+- `read_note` — read a note's contents
+- `create_note` — create a new note (optional overwrite)
+- `append_note` — append to a note (great for journals/logs)
+- `delete_note` — delete a note
+- `search_notes` — full-text search across all notes
+- `get_backlinks` — find notes linking to a note via `[[wiki-link]]` syntax
+
+**Resources**
+- Every note is exposed as a `notes://<name>` resource.
+
+All file access is sandboxed to the notes directory — paths that try to escape it are rejected.
+
+## Install & build
+
+```bash
+npm install
+npm run build
+```
+
+## Configuration
+
+Set `NOTES_DIR` to choose where notes live (defaults to `~/notes`):
+
+```bash
+export NOTES_DIR="$HOME/my-notes"
+```
+
+## Connecting to a client
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "notes": {
+      "command": "node",
+      "args": ["/absolute/path/to/mcp-suite/servers/notes/dist/index.js"],
+      "env": { "NOTES_DIR": "/absolute/path/to/your/notes" }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add notes --env NOTES_DIR=$HOME/notes -- node /absolute/path/to/mcp-suite/servers/notes/dist/index.js
+```
+
+## Publishing to npm
+
+This package publishes automatically via GitHub Actions (Trusted Publishing / OIDC) when a
+release tagged `notes-v<version>` is created. See the repo root for the CD workflow.
+
+Once published, users can run it without cloning:
+
+```json
+{
+  "mcpServers": {
+    "notes": {
+      "command": "npx",
+      "args": ["-y", "@abhishekmcp/notes"],
+      "env": { "NOTES_DIR": "/path/to/notes" }
+    }
+  }
+}
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { appendNote, createNote, deleteNote, ensureNotesDir, getBacklinks, getNotesDir, listNotes, readNote, searchNotes, } from "./notes.js";
+const server = new McpServer({
+    name: "mcp-notes-server",
+    version: "0.1.0",
+});
+// A small helper to wrap a string into the MCP text-content shape.
+const text = (value) => ({
+    content: [{ type: "text", text: value }],
+});
+// --- Tools ---------------------------------------------------------------
+server.registerTool("list_notes", {
+    title: "List notes",
+    description: "List all markdown notes in the notes directory, newest first. " +
+        "Returns each note's name, size, and last-modified time.",
+    inputSchema: {},
+}, async () => {
+    const notes = await listNotes();
+    if (notes.length === 0)
+        return text("No notes found.");
+    const lines = notes.map((n) => `- ${n.name} (${n.size} bytes, modified ${n.modified})`);
+    return text(`Found ${notes.length} note(s):\n${lines.join("\n")}`);
+});
+server.registerTool("read_note", {
+    title: "Read a note",
+    description: "Read the full contents of a note by name (extension optional).",
+    inputSchema: {
+        name: z.string().describe("Note name, e.g. 'ideas' or 'projects/mcp'"),
+    },
+}, async ({ name }) => {
+    try {
+        return text(await readNote(name));
+    }
+    catch {
+        return text(`Could not read note "${name}". Does it exist?`);
+    }
+});
+server.registerTool("create_note", {
+    title: "Create a note",
+    description: "Create a new markdown note. Fails if it already exists unless overwrite is true.",
+    inputSchema: {
+        name: z.string().describe("Note name, e.g. 'ideas' or 'projects/mcp'"),
+        content: z.string().describe("Markdown content of the note"),
+        overwrite: z
+            .boolean()
+            .optional()
+            .describe("Overwrite an existing note (default false)"),
+    },
+}, async ({ name, content, overwrite }) => {
+    try {
+        const file = await createNote(name, content, overwrite ?? false);
+        return text(`Created note at ${file}`);
+    }
+    catch (err) {
+        return text(`Failed to create note: ${err.message}`);
+    }
+});
+server.registerTool("append_note", {
+    title: "Append to a note",
+    description: "Append content to an existing note (creates it if missing). " +
+        "Useful for journals, logs, and running lists.",
+    inputSchema: {
+        name: z.string().describe("Note name"),
+        content: z.string().describe("Markdown content to append"),
+    },
+}, async ({ name, content }) => {
+    const file = await appendNote(name, content);
+    return text(`Appended to ${file}`);
+});
+server.registerTool("delete_note", {
+    title: "Delete a note",
+    description: "Permanently delete a note by name.",
+    inputSchema: {
+        name: z.string().describe("Note name to delete"),
+    },
+    annotations: { destructiveHint: true },
+}, async ({ name }) => {
+    try {
+        await deleteNote(name);
+        return text(`Deleted note "${name}".`);
+    }
+    catch {
+        return text(`Could not delete note "${name}". Does it exist?`);
+    }
+});
+server.registerTool("search_notes", {
+    title: "Search notes",
+    description: "Case-insensitive full-text search across all notes. " +
+        "Returns matching lines with their note name and line number.",
+    inputSchema: {
+        query: z.string().describe("Text to search for"),
+        limit: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Max number of matches (default 50)"),
+    },
+}, async ({ query, limit }) => {
+    const hits = await searchNotes(query, limit ?? 50);
+    if (hits.length === 0)
+        return text(`No matches for "${query}".`);
+    const lines = hits.map((h) => `${h.name}:${h.line}: ${h.text}`);
+    return text(`${hits.length} match(es):\n${lines.join("\n")}`);
+});
+server.registerTool("get_backlinks", {
+    title: "Get backlinks",
+    description: "Find all notes that link to the given note using [[wiki-link]] syntax.",
+    inputSchema: {
+        name: z.string().describe("The note to find backlinks for"),
+    },
+}, async ({ name }) => {
+    const hits = await getBacklinks(name);
+    if (hits.length === 0)
+        return text(`No notes link to "${name}".`);
+    const lines = hits.map((h) => `${h.name}:${h.line}: ${h.text}`);
+    return text(`${hits.length} backlink(s) to "${name}":\n${lines.join("\n")}`);
+});
+// --- Resources -----------------------------------------------------------
+// Expose every note as a readable resource via a notes:// URI scheme.
+server.registerResource("note", "notes://{name}", {
+    title: "Note",
+    description: "A markdown note, addressable by name.",
+    mimeType: "text/markdown",
+}, async (uri) => {
+    const name = decodeURIComponent(uri.pathname.replace(/^\/+/, "") || uri.href.replace("notes://", ""));
+    const content = await readNote(name);
+    return {
+        contents: [{ uri: uri.href, mimeType: "text/markdown", text: content }],
+    };
+});
+// --- Startup -------------------------------------------------------------
+async function main() {
+    await ensureNotesDir();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr — stdout is reserved for the MCP protocol.
+    console.error(`mcp-notes-server running. Notes dir: ${getNotesDir()}`);
+}
+main().catch((err) => {
+    console.error("Fatal error starting mcp-notes-server:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/notes.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Resolve the notes directory from the NOTES_DIR env var, defaulting to ~/notes.
+ * A leading "~" is expanded to the user's home directory.
+ */
+export declare function getNotesDir(): string;
+/** Ensure the notes directory exists. */
+export declare function ensureNotesDir(): Promise<string>;
+/**
+ * Turn a user-supplied note name into a safe absolute path inside the notes
+ * directory. Throws if the resolved path would escape the notes directory.
+ * A ".md" extension is added when missing.
+ */
+export declare function resolveNotePath(name: string): string;
+export interface NoteInfo {
+    name: string;
+    size: number;
+    modified: string;
+}
+/** Recursively list all markdown notes in the notes directory. */
+export declare function listNotes(): Promise<NoteInfo[]>;
+export declare function readNote(name: string): Promise<string>;
+export declare function createNote(name: string, content: string, overwrite?: boolean): Promise<string>;
+export declare function appendNote(name: string, content: string): Promise<string>;
+export declare function deleteNote(name: string): Promise<void>;
+export interface SearchHit {
+    name: string;
+    line: number;
+    text: string;
+}
+/** Case-insensitive substring search across all notes. */
+export declare function searchNotes(query: string, limit?: number): Promise<SearchHit[]>;
+/**
+ * Find notes that link to the given note via [[wiki-link]] syntax.
+ * Matches the bare note name (with or without the .md extension).
+ */
+export declare function getBacklinks(name: string): Promise<SearchHit[]>;

package/dist/notes.js

@@ -0,0 +1,138 @@
+import { promises as fs } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+/**
+ * Resolve the notes directory from the NOTES_DIR env var, defaulting to ~/notes.
+ * A leading "~" is expanded to the user's home directory.
+ */
+export function getNotesDir() {
+    const raw = process.env.NOTES_DIR ?? path.join(homedir(), "notes");
+    const expanded = raw.startsWith("~")
+        ? path.join(homedir(), raw.slice(1))
+        : raw;
+    return path.resolve(expanded);
+}
+/** Ensure the notes directory exists. */
+export async function ensureNotesDir() {
+    const dir = getNotesDir();
+    await fs.mkdir(dir, { recursive: true });
+    return dir;
+}
+/**
+ * Turn a user-supplied note name into a safe absolute path inside the notes
+ * directory. Throws if the resolved path would escape the notes directory.
+ * A ".md" extension is added when missing.
+ */
+export function resolveNotePath(name) {
+    const dir = getNotesDir();
+    const withExt = name.endsWith(".md") ? name : `${name}.md`;
+    const resolved = path.resolve(dir, withExt);
+    const rel = path.relative(dir, resolved);
+    if (rel.startsWith("..") || path.isAbsolute(rel)) {
+        throw new Error(`Refusing to access "${name}": path escapes the notes directory.`);
+    }
+    return resolved;
+}
+/** Recursively list all markdown notes in the notes directory. */
+export async function listNotes() {
+    const dir = await ensureNotesDir();
+    const results = [];
+    async function walk(current) {
+        const entries = await fs.readdir(current, { withFileTypes: true });
+        for (const entry of entries) {
+            const full = path.join(current, entry.name);
+            if (entry.isDirectory()) {
+                await walk(full);
+            }
+            else if (entry.isFile() && entry.name.endsWith(".md")) {
+                const stat = await fs.stat(full);
+                const rel = path.relative(dir, full).replace(/\.md$/, "");
+                results.push({
+                    name: rel,
+                    size: stat.size,
+                    modified: stat.mtime.toISOString(),
+                });
+            }
+        }
+    }
+    await walk(dir);
+    results.sort((a, b) => b.modified.localeCompare(a.modified));
+    return results;
+}
+export async function readNote(name) {
+    const file = resolveNotePath(name);
+    return fs.readFile(file, "utf8");
+}
+export async function createNote(name, content, overwrite = false) {
+    const file = resolveNotePath(name);
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    if (!overwrite) {
+        try {
+            await fs.access(file);
+            throw new Error(`Note "${name}" already exists. Use overwrite or append instead.`);
+        }
+        catch (err) {
+            // ENOENT means it does not exist yet — that's what we want.
+            if (err.code !== "ENOENT")
+                throw err;
+        }
+    }
+    await fs.writeFile(file, content, "utf8");
+    return file;
+}
+export async function appendNote(name, content) {
+    const file = resolveNotePath(name);
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    // Separate appended content with a blank line for readability.
+    const prefix = content.startsWith("\n") ? "" : "\n\n";
+    await fs.appendFile(file, prefix + content, "utf8");
+    return file;
+}
+export async function deleteNote(name) {
+    const file = resolveNotePath(name);
+    await fs.unlink(file);
+}
+/** Case-insensitive substring search across all notes. */
+export async function searchNotes(query, limit = 50) {
+    const notes = await listNotes();
+    const needle = query.toLowerCase();
+    const hits = [];
+    for (const note of notes) {
+        const content = await readNote(note.name);
+        const lines = content.split("\n");
+        for (let i = 0; i < lines.length; i++) {
+            if (lines[i].toLowerCase().includes(needle)) {
+                hits.push({ name: note.name, line: i + 1, text: lines[i].trim() });
+                if (hits.length >= limit)
+                    return hits;
+            }
+        }
+    }
+    return hits;
+}
+/**
+ * Find notes that link to the given note via [[wiki-link]] syntax.
+ * Matches the bare note name (with or without the .md extension).
+ */
+export async function getBacklinks(name) {
+    const target = name.replace(/\.md$/, "");
+    const notes = await listNotes();
+    const hits = [];
+    for (const note of notes) {
+        if (note.name === target)
+            continue;
+        const content = await readNote(note.name);
+        const lines = content.split("\n");
+        for (let i = 0; i < lines.length; i++) {
+            const wikiLinks = lines[i].match(/\[\[([^\]]+)\]\]/g) ?? [];
+            for (const link of wikiLinks) {
+                const inner = link.slice(2, -2).split("|")[0].trim().replace(/\.md$/, "");
+                if (inner === target) {
+                    hits.push({ name: note.name, line: i + 1, text: lines[i].trim() });
+                }
+            }
+        }
+    }
+    return hits;
+}
+//# sourceMappingURL=notes.js.map

package/dist/notes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.js","sourceRoot":"","sources":["../src/notes.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@abhishekmcp/notes",
+  "version": "0.1.0",
+  "description": "MCP server for local markdown notes — search, create, link, and read notes from any MCP client.",
+  "type": "module",
+  "bin": {
+    "mcp-notes": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "start": "node dist/index.js",
+    "dev": "tsc && node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "modelcontextprotocol",
+    "notes",
+    "markdown",
+    "claude"
+  ],
+  "author": "Abhishek (https://github.com/Abhishekkumar2021)",
+  "license": "MIT",
+  "homepage": "https://github.com/Abhishekkumar2021/mcp-suite/tree/main/servers/notes#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Abhishekkumar2021/mcp-suite.git",
+    "directory": "servers/notes"
+  },
+  "bugs": {
+    "url": "https://github.com/Abhishekkumar2021/mcp-suite/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  }
+}