---
name: SerenNotes
version: 1.0.0
description: "AI-native notes service for agents. Store, search, and organize unstructured context with full-text search, hierarchical organization, and multiple content formats."
homepage: https://notes.serendb.com/api
metadata: {"seren":{"category":"integration","publisher_slug":"seren-notes","api_base":"https://api.serendb.com"}}
---

# SerenNotes

AI-native notes service for agents. Store, search, and organize unstructured context with full-text search, hierarchical organization, and multiple content formats.

## API Endpoints

### POST `/notes`

Create a new note

**Example:**

```bash
curl -X POST https://api.serendb.com/publishers/seren-notes/notes \
  -H "Authorization: Bearer $SEREN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### GET `/notes`

List notes with optional filters

**Example:**

```bash
curl -X GET https://api.serendb.com/publishers/seren-notes/notes \
  -H "Authorization: Bearer $SEREN_API_KEY"
```

### GET `/notes/search`

Full-text search notes

**Example:**

```bash
curl -X GET https://api.serendb.com/publishers/seren-notes/notes/search \
  -H "Authorization: Bearer $SEREN_API_KEY"
```

### GET `/notes/{note_id}`

Get a specific note

**Example:**

```bash
curl -X GET https://api.serendb.com/publishers/seren-notes/notes/{note_id} \
  -H "Authorization: Bearer $SEREN_API_KEY"
```

### PATCH `/notes/{note_id}`

Update a note

**Example:**

```bash
curl -X PATCH https://api.serendb.com/publishers/seren-notes/notes/{note_id} \
  -H "Authorization: Bearer $SEREN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### DELETE `/notes/{note_id}`

Delete a note

**Example:**

```bash
curl -X DELETE https://api.serendb.com/publishers/seren-notes/notes/{note_id} \
  -H "Authorization: Bearer $SEREN_API_KEY"
```

### POST `/notes/{note_id}/append`

Append content to a note

**Example:**

```bash
curl -X POST https://api.serendb.com/publishers/seren-notes/notes/{note_id}/append \
  -H "Authorization: Bearer $SEREN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### GET `/notes/tags`

List all tags

**Example:**

```bash
curl -X GET https://api.serendb.com/publishers/seren-notes/notes/tags \
  -H "Authorization: Bearer $SEREN_API_KEY"
```

### POST `/notes/{note_id}/tags`

Add tags to a note

**Example:**

```bash
curl -X POST https://api.serendb.com/publishers/seren-notes/notes/{note_id}/tags \
  -H "Authorization: Bearer $SEREN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### DELETE `/notes/{note_id}/tags`

Remove tags from a note

**Example:**

```bash
curl -X DELETE https://api.serendb.com/publishers/seren-notes/notes/{note_id}/tags \
  -H "Authorization: Bearer $SEREN_API_KEY"
```

## MCP Tools

This API publisher also supports MCP (Model Context Protocol) access. Each API endpoint is available as an MCP tool.

### Available Tools

- `post_notes`: Create a new note
- `get_notes`: List notes with optional filters
- `get_notes_search`: Full-text search notes
- `get_notes_by_note_id`: Get a specific note
- `patch_notes_by_note_id`: Update a note
- `delete_notes_by_note_id`: Delete a note
- `post_notes_by_note_id_append`: Append content to a note
- `get_notes_tags`: List all tags
- `post_notes_by_note_id_tags`: Add tags to a note
- `delete_notes_by_note_id_tags`: Remove tags from a note

### Introspection

```bash
# List tools
curl https://api.serendb.com/publishers/seren-notes/_mcp/tools \
  -H "Authorization: Bearer $SEREN_API_KEY"

# Call a tool
curl -X POST https://api.serendb.com/publishers/seren-notes/_mcp/tools/{tool_name} \
  -H "Authorization: Bearer $SEREN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"body": {"key": "value"}}'
```

## Pricing

**Pricing Model:** per_request


**Per-method pricing:**
- GET: $0.00010000
- POST: $0.00050000
- PUT: $0.00050000
- DELETE: $0.00010000
- PATCH: $0.00050000

**Minimum charge:** $0.00010000

---

## Need Help?

- Seren Docs: https://docs.serendb.com
- Publisher: AI-native notes service for agents. Store, search, and organize unstructured context with full-text search, hierarchical organization, and multiple content formats.