keepsake-mcp 1.2.0 → 1.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +50 -6
- package/build/index.js +8 -775
- package/build/tools.js +776 -0
- package/package.json +5 -1
package/README.md
CHANGED
|
@@ -20,9 +20,43 @@ Your AI assistant becomes a personal relationship manager. Ask it to:
|
|
|
20
20
|
|
|
21
21
|
Sign up at [keepsake.place](https://keepsake.place), then go to **Account > API Keys** to generate one.
|
|
22
22
|
|
|
23
|
-
### 2.
|
|
23
|
+
### 2. Choose your connection method
|
|
24
24
|
|
|
25
|
-
####
|
|
25
|
+
#### Option A: Remote (HTTP) — recommended
|
|
26
|
+
|
|
27
|
+
No installation required. Works with Claude iOS, Claude web, Claude Desktop Connectors, and any MCP client that supports Streamable HTTP.
|
|
28
|
+
|
|
29
|
+
**Endpoint:** `https://app.keepsake.place/api/mcp`
|
|
30
|
+
|
|
31
|
+
**Authentication:** Pass your API key as a Bearer token in the `Authorization` header.
|
|
32
|
+
|
|
33
|
+
**Claude Desktop (Connectors):**
|
|
34
|
+
|
|
35
|
+
Add a remote MCP server in Claude Desktop settings with:
|
|
36
|
+
- URL: `https://app.keepsake.place/api/mcp`
|
|
37
|
+
- Authentication: Bearer token with your `ksk_` API key
|
|
38
|
+
|
|
39
|
+
**Any MCP client (Streamable HTTP):**
|
|
40
|
+
|
|
41
|
+
```json
|
|
42
|
+
{
|
|
43
|
+
"mcpServers": {
|
|
44
|
+
"keepsake": {
|
|
45
|
+
"type": "streamable-http",
|
|
46
|
+
"url": "https://app.keepsake.place/api/mcp",
|
|
47
|
+
"headers": {
|
|
48
|
+
"Authorization": "Bearer ksk_YOUR_API_KEY"
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
#### Option B: Local (stdio)
|
|
56
|
+
|
|
57
|
+
Runs locally via `npx`. Useful for Claude Code, Cursor, and local development.
|
|
58
|
+
|
|
59
|
+
**Claude Desktop:**
|
|
26
60
|
|
|
27
61
|
Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
|
|
28
62
|
|
|
@@ -40,7 +74,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
|
|
|
40
74
|
}
|
|
41
75
|
```
|
|
42
76
|
|
|
43
|
-
|
|
77
|
+
**Claude Code:**
|
|
44
78
|
|
|
45
79
|
```bash
|
|
46
80
|
claude mcp add keepsake -- npx -y keepsake-mcp
|
|
@@ -48,7 +82,7 @@ claude mcp add keepsake -- npx -y keepsake-mcp
|
|
|
48
82
|
|
|
49
83
|
Then set `KEEPSAKE_API_KEY` in your environment.
|
|
50
84
|
|
|
51
|
-
|
|
85
|
+
**Cursor:**
|
|
52
86
|
|
|
53
87
|
Add to `.cursor/mcp.json` in your project:
|
|
54
88
|
|
|
@@ -66,7 +100,7 @@ Add to `.cursor/mcp.json` in your project:
|
|
|
66
100
|
}
|
|
67
101
|
```
|
|
68
102
|
|
|
69
|
-
## Available tools (
|
|
103
|
+
## Available tools (58)
|
|
70
104
|
|
|
71
105
|
### Contacts
|
|
72
106
|
| Tool | Description |
|
|
@@ -110,7 +144,7 @@ Add to `.cursor/mcp.json` in your project:
|
|
|
110
144
|
| `get_tasks_today` | Today's tasks: overdue + due today + ASAP |
|
|
111
145
|
| `get_tasks_overdue` | Only overdue tasks |
|
|
112
146
|
|
|
113
|
-
###
|
|
147
|
+
### QuickNotes
|
|
114
148
|
| Tool | Description |
|
|
115
149
|
|------|-------------|
|
|
116
150
|
| `list_notes` | List notes (filter by pinned/archived) |
|
|
@@ -149,6 +183,16 @@ Add to `.cursor/mcp.json` in your project:
|
|
|
149
183
|
| `update_task_header` | Update a task header (name, description, collapsed) |
|
|
150
184
|
| `delete_task_header` | Permanently delete a task header |
|
|
151
185
|
|
|
186
|
+
### Contact Links
|
|
187
|
+
| Tool | Description |
|
|
188
|
+
|------|-------------|
|
|
189
|
+
| `link_note_contact` | Link a contact to a note |
|
|
190
|
+
| `unlink_note_contact` | Remove a contact link from a note |
|
|
191
|
+
| `link_entry_contact` | Link a contact to an entry |
|
|
192
|
+
| `unlink_entry_contact` | Remove a contact link from an entry |
|
|
193
|
+
| `link_task_contact` | Link a contact to a task |
|
|
194
|
+
| `unlink_task_contact` | Remove a contact link from a task |
|
|
195
|
+
|
|
152
196
|
### Utilities
|
|
153
197
|
| Tool | Description |
|
|
154
198
|
|------|-------------|
|