Connect AI agents to the Plaud MCP server

1
// Step 1 — find the recording. `query` matches the name, case-insensitively.
2
const listResult = await scalekit.actions.executeTool({
3
  toolName: 'plaudmcp_list_files',
4
  identifier: 'user_123',
5
  connector: 'plaudmcp',
6
  toolInput: {
7
    query: 'weekly sync',
8
    date_from: '2026-01-01',
9
    date_to: '2026-01-31',
10
  },
11
});
12

13
// Inspect the payload once to learn how Plaud names the recording list and
14
// its file IDs, then read those fields directly in your own code.
15
// Security: Log only in development; recording names may expose user data.
16
console.log(listResult.data);
17

18
// Step 2 — read the AI notes for a recording you picked from that payload.
19
const noteResult = await scalekit.actions.executeTool({
20
  toolName: 'plaudmcp_get_note',
21
  identifier: 'user_123',
22
  connector: 'plaudmcp',
23
  toolInput: { file_id: '66f2b1c8e4b0a1d2c3e4f5a6' },
24
});
25

26
// Security: AI notes summarize the recording. Log only in development, and
27
// pass the notes to your agent rather than persisting them.
28
console.log(noteResult.data);

1
# Step 1 — find the recording. `query` matches the name, case-insensitively.
2
list_response = actions.execute_tool(
3
    tool_name="plaudmcp_list_files",
4
    identifier="user_123",
5
    connection_name="plaudmcp",
6
    tool_input={
7
        "query": "weekly sync",
8
        "date_from": "2026-01-01",
9
        "date_to": "2026-01-31",
10
    },
11
)
12

13
# Inspect the payload once to learn how Plaud names the recording list and
14
# its file IDs, then read those fields directly in your own code.
15
# Security: Log only in development; recording names may expose user data.
16
print(list_response.data)
17

18
# Step 2 — read the AI notes for a recording you picked from that payload.
19
note_response = actions.execute_tool(
20
    tool_name="plaudmcp_get_note",
21
    identifier="user_123",
22
    connection_name="plaudmcp",
23
    tool_input={"file_id": "66f2b1c8e4b0a1d2c3e4f5a6"},
24
)
25

26
# Security: AI notes summarize the recording. Log only in development, and
27
# pass the notes to your agent rather than persisting them.
28
print(note_response.data)

1
const pages = [];
2
let cursor: string | undefined = undefined;
3

4
do {
5
  const result = await scalekit.actions.executeTool({
6
    toolName: 'plaudmcp_get_transcript',
7
    identifier: 'user_123',
8
    connector: 'plaudmcp',
9
    toolInput: {
10
      file_id: '66f2b1c8e4b0a1d2c3e4f5a6',
11
      block: 'transaction', // raw transcript with speaker names and timestamps
12
      limit: 200,
13
      ...(cursor ? { cursor } : {}),
14
    },
15
  });
16

17
  pages.push(result.data);
18
  cursor = (result.data as { next_cursor?: string }).next_cursor;
19
} while (cursor);
20

21
console.log(`Fetched ${pages.length} transcript page(s)`);

1
pages = []
2
cursor = None
3

4
while True:
5
    tool_input = {
6
        "file_id": "66f2b1c8e4b0a1d2c3e4f5a6",
7
        "block": "transaction",  # raw transcript with speaker names and timestamps
8
        "limit": 200,
9
    }
10
    if cursor:
11
        tool_input["cursor"] = cursor
12

13
    response = actions.execute_tool(
14
        tool_name="plaudmcp_get_transcript",
15
        identifier="user_123",
16
        connection_name="plaudmcp",
17
        tool_input=tool_input,
18
    )
19

20
    pages.append(response.data)
21
    cursor = response.data.get("next_cursor")
22
    if not cursor:
23
        break
24

25
print(f"Fetched {len(pages)} transcript page(s)")

const result = await scalekit.actions.executeTool({
  toolName: 'plaudmcp_get_file',
  identifier: 'user_123',
  connector: 'plaudmcp',
  toolInput: { file_id: '66f2b1c8e4b0a1d2c3e4f5a6' },
});

// Security: Log only in development; recordings may contain sensitive content.
console.log(result.data);

response = actions.execute_tool(
    tool_name="plaudmcp_get_file",
    identifier="user_123",
    connection_name="plaudmcp",
    tool_input={"file_id": "66f2b1c8e4b0a1d2c3e4f5a6"},
)

# Security: Log only in development; recordings may contain sensitive content.
print(response.data)