aside-notion

Notion

Use the notion global in the REPL tool. It extracts token_v2 from the logged-in Notion browser session — no tab navigation needed.

Quick Reference

// If multiple Notion accounts/workspaces may be logged in, inspect and select explicitly.
console.log(await notion.listAccounts());

// Get an initialized NotionClient (cached per Chrome profile).
// IMPORTANT: Use const so you can reuse the client across REPL calls.
const _notion = await notion.getClient({
  email: '[email protected]',
  workspaceName: 'Corca',
});

// Current user info
console.log(_notion.currentUser.email, _notion.currentUser.fullName);
console.log('Space:', _notion.currentSpace.get('name'));
console.log('Plan:', _notion.currentSpace.get('subscription_tier'));

// Search pages
const results = await _notion.search({ query: 'meeting notes', isNavigableOnly: true, limit: 10 });
for (const block of results) {
  console.log(block.id, block.get('type'), block.title);
}

// Get a page by URL or ID
const page = await _notion.getBlock('https://www.notion.so/myorg/My-Page-abc123');
console.log(page.title);

// Read page as markdown (fast, local conversion, no API call)
console.log(blockToMarkdown(page));

// Append markdown to a page
await page.children.addFromMarkdown(`
## Agent update

- [x] searched the workspace
- [x] appended a section
`);

// Create a child page
const child = await page.children.addNew('page', { title: 'New Sub-page' });
await child.children.addFromMarkdown('# Hello\n\nContent here.');

// Update page title
await page.set('properties.title', [['Updated Title']]);

Getting the Client

// Always assign to a const for reuse across REPL calls
const _notion = await notion.getClient();

The returned client is NotionClient from @aside/notion — a full-featured Notion internal API client. All operations below use this client.

If the token expires or you switch accounts:

notion.invalidateCache();
const refreshedNotion = await notion.getClient();