https://github.com/krasun/notes-mcp
An MCP server that connects with your Apple Notes on macOS.
https://github.com/krasun/notes-mcp
Last synced: 3 months ago
JSON representation
An MCP server that connects with your Apple Notes on macOS.
- Host: GitHub
- URL: https://github.com/krasun/notes-mcp
- Owner: krasun
- License: mit
- Created: 2025-05-21T07:33:11.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-05-22T13:49:08.000Z (5 months ago)
- Last Synced: 2025-07-15T07:35:33.821Z (3 months ago)
- Language: TypeScript
- Size: 10.6 MB
- Stars: 68
- Watchers: 1
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Notes MCP
An MCP server that connects with your Apple Notes on macOS.
## Supported Tools
- `notes-get-folders`: Get all folders.
- `notes-get-notes`: Get all notes in a folder.
- `notes-create-note`: Create a new note with title and content.
- `notes-get-note-by-id`: Get a note by its identifier.
- `notes-get-note-by-title`: Find a note by exact match of title.
- `notes-get-note-count`: Get the total number of notes.
## Usage
### Build it
Always install dependencies and build it first:
```bash
npm install && npm run build
```
### With Claude for Desktop
Add the following to your `~/Library/Application\ Support/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"notes": {
"command": "node",
"args": ["path/to/notes/mcp/dist/index.js"]
}
}
}
```
And check it is running in Claude settings:
### With Cursor
```json
{
"mcpServers": {
"notes": {
"command": "node",
"args": ["path/to/notes/mcp/dist/index.js"]
}
}
}
```
And then check Cursor MCP settings:
### Standalone or for other projects
```bash
node dist/index.js
```
## License
`Notes MCP` is licensed [under the MIT License](LICENSE).