Notion Integration

Notion Integration

Connect Notion to search pages, databases, and documentation across your workspace.

What You Can Query

Content Type	Description
Pages	Documents, notes, wiki pages
Databases	Tables, boards, lists
Properties	Metadata from database items
Content	Page text, headings, lists

Connecting Notion

1. Log into TeamLoop at app.teamloop.io
2. Navigate to Settings > Integrations
3. Click Connect next to Notion
4. Select the pages and databases to share with TeamLoop
5. Click Allow access

Permissions

TeamLoop requests:

• Read content from selected pages
• Read database properties
• Read comments

We never modify your Notion workspace.

Selecting Content

During authorization, you choose which pages/databases TeamLoop can access:

• Select specific pages
• Select entire databases
• Grant workspace-wide access (admin only)

Example Queries

Search Documentation

teamloop_query:
  query: "API design guidelines"
  sources: "notion"

Find Meeting Notes

teamloop_query:
  query: "engineering sync meeting notes Q4"
  sources: "notion"

Search PRDs

teamloop_query:
  query: "product requirements user authentication"
  sources: "notion"

Entity Extraction

Notion content maps to TeamLoop entity types:

Notion Content	TeamLoop Entity
Page	DOCUMENT
Database item	DOCUMENT
Decision doc	DECISION
Person mention	PERSON
Project page	PROJECT

Example Extraction

From a Notion PRD:

{
  "entities": [
    {
      "type": "DOCUMENT",
      "name": "User Authentication PRD v2",
      "description": "Product requirements for new auth flow",
      "source_url": "https://notion.so/...",
      "source_integration": "notion",
      "event_date": "2024-04-15"
    },
    {
      "type": "DECISION",
      "name": "Use passwordless authentication",
      "rationale": "Improve UX and security",
      "alternatives": ["Password + 2FA", "Social login only"],
      "event_date": "2024-04-20"
    },
    {
      "type": "PERSON",
      "name": "Alice Chen",
      "description": "Product Manager, authored the PRD"
    }
  ]
}

Best Practices

1. Organize Notion for Discoverability

Structure helps TeamLoop find relevant content:

├── Engineering/
│   ├── Architecture/
│   │   ├── ADRs/
│   │   └── System Design/
│   └── Processes/
├── Product/
│   ├── PRDs/
│   └── Roadmaps/
└── Meeting Notes/

2. Use Database Properties

Notion databases with rich properties work well:

Property	Use
Status	Track decision state
Owner	Link to people
Date	Temporal queries
Tags	Topic categorization

3. Include Context in Pages

TeamLoop extracts better entities from well-documented pages:

## Decision: Adopt PostgreSQL

**Date:** 2024-03-15
**Status:** Accepted
**Owner:** @Alice

### Context
We need a database that supports...

### Alternatives Considered
- MySQL
- MongoDB

### Decision
We will use PostgreSQL because...

4. Link Related Content

Notion links become relationships in TeamLoop:

• Link PRDs to ADRs
• Link decisions to meeting notes
• Link components to documentation

Temporal Queries with Notion

Point-in-Time

What was documented on a specific date:

teamloop_query:
  query: "authentication design"
  sources: "notion"
  mode: "as_of"
  as_of: "2024-06-01"

Track Documentation Evolution

teamloop_evolution:
  query: "product roadmap"
  from_date: "2024-01-01"
  to_date: "2024-12-31"

Database Queries

TeamLoop can search Notion databases:

teamloop_query:
  query: "status:In Progress type:PRD"
  sources: "notion"

Results include:

• Database item title
• Property values
• Page content
• Last edited date

Troubleshooting

No Results

• Verify pages are shared with TeamLoop integration
• Check the Notion integration settings
• Ensure pages aren’t in private sections
• Try broader search terms

Missing Pages

Pages must be explicitly shared with the TeamLoop integration:

1. Go to the page in Notion
2. Click Share in the top right
3. Add TeamLoop integration
4. Or share the parent page/database

Access Errors

• Re-authorize the integration
• Check that the page isn’t restricted
• Verify workspace permissions

Search Tips

Title Search

Include page titles for better matches:

teamloop_query:
  query: "\"User Authentication PRD\""
  sources: "notion"

Property Filters

Reference database properties:

teamloop_query:
  query: "type:ADR status:Accepted"
  sources: "notion"

Date Ranges

For meeting notes or dated content:

teamloop_query:
  query: "engineering sync November 2024"
  sources: "notion"

Security

• OAuth tokens are encrypted at rest
• Only accesses content you explicitly share
• You can revoke access from Notion settings
• TeamLoop never writes to Notion

Syncing

Notion content is fetched fresh on each query:

• Always see latest content
• No background sync needed
• Cached for subsequent queries (7 day TTL)

Next Steps

• GitHub Integration - Connect GitHub
• Linear Integration - Connect Linear
• Knowledge Graphs - Understand entities