# notes-mcp

An MCP server that exposes your local Markdown notes to AI assistants. Supports keyword search across all `.md` files in a directory.

## Tools

### `search_notes`

Searches all notes using term-frequency scoring and returns ranked results with snippets.

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `query` | string | required | Search terms (space-separated) |
| `limit` | integer (1–20) | `5` | Maximum number of results to return |

## Setup

### 1. Install dependencies

```bash
npm install
```

### 2. Build

```bash
npm run build
```

### 3. Configure

Set the `NOTES_DIR` environment variable to the directory containing your `.md` files:

```bash
export NOTES_DIR=/path/to/your/notes
```

### 4. Add to your MCP client

In Claude Code (`~/.claude/claude_desktop_config.json` or similar):

```json
{
  "mcpServers": {
    "notes": {
      "command": "node",
      "args": ["/path/to/notes-mcp/build/index.js"],
      "env": {
        "NOTES_DIR": "/path/to/your/notes"
      }
    }
  }
}
```

## Requirements

- Node.js 18+
- Markdown notes in a flat directory (subdirectories are not searched)