Marin Docs

Notion Integration

Marin's Notion integration allows your AI assistant to interact with your Notion workspace, enabling it to read, create, and update pages and databases based on your email conversations and tasks.

What Can Marin Do With Notion?

ActionExample Request
Create pages"Create a Notion page summarizing this project discussion"
Add to databases"Add these tasks to my Notion task tracker"
Search workspace"Search my Notion for Q4 marketing strategy"
Update existing entries"Update the project status in my Notion database"
Marin can only access pages and databases that you explicitly share with the integration. Your private pages remain completely private.

Key Features

Notion Page Creation

The AI can automatically create Notion pages in your workspace based on email content, meeting notes, or task discussions.

  • Creating meeting notes from email threads
  • Generating project documentation
  • Saving important information to your knowledge base
  • Creating task lists and project plans

Notion Database Integration

Connect to your Notion databases to automatically track tasks, projects, and information.

  • Add items to databases
  • Update existing entries
  • Query database contents
  • Filter and search records

Content Search

Search across your Notion workspace to find relevant information and pages.

  • Full-text search across pages
  • Database queries
  • Filtering by properties
  • Recent pages access

Page Updates

Update existing Notion pages with new information from emails or conversations.

  • Append content to existing pages
  • Update page properties
  • Add comments and mentions
  • Modify database entries

Setting Up Notion Integration

Step 1: Create a Notion Integration

  1. Go to Notion Integrations
  2. Click "+ New integration"
  3. Fill in the details:
    • Name: "Marin Assistant"
    • Logo: Upload your logo (optional)
    • Associated workspace: Select your workspace
  4. Set Capabilities:
    • ✅ Read content
    • ✅ Update content
    • ✅ Insert content
  5. Click "Submit"
  6. Copy your Internal Integration Token (starts with secret_)

Step 2: Share Pages with Integration

For Marin to access your Notion pages, you need to explicitly share them with the integration:

  1. Open any Notion page you want to share
  2. Click "Share" in the top right
  3. Click "Invite"
  4. Search for "Marin Assistant" (your integration name)
  5. Select it and set permissions
  6. Repeat for any databases or pages you want accessible

Step 3: Connect to Marin

  1. Go to your Marin dashboard
  2. Navigate to Settings → Connections
  3. Click "Connect Notion"
  4. Paste your integration token
  5. (Optional) Enter your workspace name for identification
  6. Click "Connect"

Best Practices

Security

  • Never share your integration token publicly or in code
  • Create separate integrations for development and production
  • Only share necessary pages with the integration (principle of least privilege)
  • Regularly audit which pages are shared with integrations
  • Revoke and regenerate tokens periodically

Organization

  • Use consistent naming conventions for pages created by Marin
  • Create dedicated databases for AI-generated content
  • Set up templates for common page types
  • Use properties and tags to organize AI-created content

Performance

  • Share only the pages and databases you need
  • Avoid creating duplicate pages (use search first)
  • Batch related operations when possible
  • Keep page content focused and structured

Usage Examples

Creating a Meeting Summary

"Create a Notion page with today's meeting notes"

Marin creates a page with:

  • Meeting title and date
  • Attendees
  • Key discussion points
  • Action items
  • Next steps

Adding Tasks to Database

"Add these tasks to my Notion task tracker: Review Q1 budget, Schedule team meeting, Update project timeline"

Marin adds three new entries to your tasks database with appropriate properties.

Research and Knowledge Base

"Search my Notion for information about our Q4 marketing strategy"

Marin searches and provides relevant information from your Notion pages.

Limitations

Notion API Limitations

  • Rate Limits: 3 requests per second per integration
  • Content Size: Maximum 2000 characters per block
  • Search: Limited to titles and properties (not full content)
  • File Uploads: Limited file types and sizes

Marin-Specific Limitations

  • Pages must be explicitly shared with the integration
  • Cannot access personal pages unless shared
  • Some advanced Notion features may not be supported
  • Databases must have compatible property types

Privacy & Security

What Marin Accesses

  • Only pages and databases explicitly shared with the integration
  • Page titles, content, and properties
  • Database schemas and entries

What Marin Does NOT Access

  • Private pages not shared with the integration
  • Other users' private workspaces
  • Pages you haven't explicitly shared
  • Notion account credentials
Integration token is stored encrypted in AWS. No Notion content is cached without permission. All operations are logged for audit purposes.