Integrations

PraxisNote integrates with external services to bring context into your notes and meetings. All integrations are managed from the Settings page (gear icon in the sidebar).

Google Calendar

Connect your Google Calendar to automatically import upcoming meetings into PraxisNote with their titles, times, and attendees pre-filled.

What Gets Imported

When you sync, PraxisNote imports calendar events for the next 7 days:

• Event title — becomes the meeting title
• Start time — becomes the meeting date/time
• Attendees — imported as a comma-separated list

Privacy

Only event titles, times, and attendees are imported. No calendar data is stored beyond what appears in your meetings list. PraxisNote does not access event descriptions, attachments, or recurring event rules.

Connecting

1. Go to Settings from the sidebar.
2. Find the Calendar Integration section.
3. Click Connect Google Calendar.
4. You’ll be redirected to Google to authorize PraxisNote.
5. Grant permission to read your calendar events.
6. You’re redirected back to Settings with a “Connected” confirmation.

Syncing Events

Once connected, the Calendar Integration section shows:

• Connected since — when you first connected
• Last synced — timestamp of the most recent sync

To import meetings:

1. Click Sync Now in the Calendar Integration section.
2. PraxisNote fetches your events for the next 7 days.
3. A result summary shows how many meetings were imported and how many were skipped (already existed).
4. New meetings appear in your meetings list, ready for recording and analysis.

Tip

You can also sync from the Meetings page by clicking Import and using the Calendar tab. This provides the same functionality with a preview of events before importing.

Disconnecting

1. Go to Settings > Calendar Integration.
2. Click Disconnect.
3. A confirmation toast appears.

Your previously imported meetings remain in PraxisNote after disconnecting. Only the calendar connection is removed.

Troubleshooting

Problem	Solution
”Access denied” during connection	Make sure you click “Allow” on the Google consent screen. Try again if you accidentally denied access.
”Authorization failed”	Clear your browser cookies and try again. This can happen if the OAuth state gets corrupted.
”Not authenticated”	Make sure you’re logged into PraxisNote first, then connect your calendar.
”Could not get full access”	Google didn’t provide a refresh token. Go to your Google Account permissions, revoke PraxisNote access, then reconnect.
Sync shows 0 new meetings	Events for the next 7 days may already be imported. Check your meetings list.

Jira

Connect your Jira Cloud account to embed rich issue chips directly in your notes.

What It Does

Once connected, Jira issue URLs in your notes render as rich inline chips showing:

Chip element	Description
Issue type icon	Task, Bug, Story, Epic, etc.
Issue key	e.g., PROJ-123
Summary	Issue title (truncated to fit inline)
Status badge	Color-coded: To Do (blue), In Progress (yellow), Done (green)

Click any chip to open the issue in Jira in a new tab.

Connecting

1. Go to Settings from the sidebar.
2. Find the Jira Integration section.
3. Click Connect Jira.
4. You’ll be redirected to Atlassian to authorize PraxisNote.
5. Grant permission to read your Jira issues.
6. You’re redirected back to Settings with a “Connected” confirmation showing your Jira site URL.

Using Jira Links in Notes

There are two ways to insert a Jira issue link:

Paste a URL

Copy a Jira issue URL from your browser (e.g., https://myorg.atlassian.net/browse/PROJ-123) and paste it into a note. PraxisNote’s smart paste automatically detects the Jira URL and converts it into a rich chip.

Slash Command

Type /jira in a note to open a prompt. Enter the Jira issue URL and the chip is inserted at your cursor position.

The chip initially shows “Loading…” while PraxisNote fetches the issue details from Jira. After a moment, it updates with the full issue information.

Disconnecting

1. Go to Settings > Jira Integration.
2. Click Disconnect.

Existing Jira chips in your notes remain visible but won’t update if the issue changes in Jira after disconnection.

Supported Jira Instances

Instance type	Supported
Jira Cloud (atlassian.net)	Yes
Jira Server (self-hosted)	No
Jira Data Center	No

Troubleshooting

Problem	Solution
”Access denied” during connection	Make sure you click “Accept” on the Atlassian consent screen.
”Authorization failed”	Clear browser cookies and try again.
”No accessible Jira sites found”	Your Atlassian account may not have access to any Jira Cloud instances. Check your Atlassian account settings.
Chip shows “Loading…” indefinitely	The issue may have been deleted or you may have lost access. Check the URL is still valid in Jira.
Pasted URL not converting to chip	Make sure Jira is connected (check Settings). The URL must be a valid Jira Cloud URL in the format https://[org].atlassian.net/browse/[KEY-123].

MCP Server (AI Assistants)

PraxisNote includes a built-in Model Context Protocol (MCP) server that lets AI assistants like Claude Code, Cursor, and other MCP-compatible tools read and write your PraxisNote data directly.

What It Enables

Once connected, an AI assistant can:

• Read your tasks, notes, meetings, and tags
• Create new tasks, notes, and meetings
• Update existing items (mark tasks complete, edit note content, etc.)
• Search across your data to answer questions or generate summaries

All operations respect your active profile and authentication, so the AI only accesses data you have permission to see.

Creating an API Key

1. Go to Settings from the sidebar.
2. Scroll down to the API Keys section.
3. Click New API Key.
4. Enter a descriptive name (e.g., “Claude Code” or “Cursor”).
5. Optionally select an expiry period (30 days, 60 days, 90 days, 1 year, or never).
6. Click Create.
7. Copy the key immediately — it starts with pn_ and will only be shown once.

Save your key

The raw API key is displayed only once when you create it. If you lose it, you’ll need to revoke the old key and create a new one.

Configuring MCP Clients

The MCP endpoint URL and API key are displayed in the API Keys section of Settings. Use them to configure your MCP client.

Claude Code

Add to your project-level .mcp.json:

{
  "mcpServers": {
    "praxisnote": {
      "type": "http",
      "url": "https://app.praxisnote.app/mcp",
      "headers": {
        "Authorization": "Bearer pn_your_api_key_here"
      }
    }
  }
}

Cursor

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "praxisnote": {
      "url": "https://app.praxisnote.app/mcp",
      "headers": {
        "Authorization": "Bearer pn_your_api_key_here"
      }
    }
  }
}

Other Clients

Use these connection details with any MCP-compatible client:

• Endpoint URL: https://app.praxisnote.app/mcp (shown in Settings)
• Authentication: Bearer token in the Authorization header
• Token format: Bearer pn_your_api_key_here

Security

• API keys are hashed before storage — PraxisNote never stores the raw key
• Each key is scoped to your user account and active profile
• You can create up to 5 active keys per account
• Keys can be revoked at any time from Settings, taking effect immediately
• Optional expiry dates automatically disable keys after the chosen period

Managing Keys

From the API Keys section in Settings you can:

• View all active keys with their name, prefix, creation date, and last-used timestamp
• Copy the MCP endpoint URL with one click
• Revoke any key by clicking the trash icon and confirming

Troubleshooting

Problem	Solution
”Unauthorized” or “Invalid API key”	Verify the key starts with pn_ and is copied correctly. Check that you’re using Bearer (with a space) before the key.
Key expired	Create a new key from Settings. Expired keys cannot be reactivated.
”Rate limited” (429 error)	The MCP server has rate limits to prevent abuse. Wait a moment and retry.
Wrong data showing	The API key is tied to the profile that was active when the key was created. Create a new key while the desired profile is active.
”Maximum number of API keys reached”	Revoke unused keys first. The limit is 5 active keys per account.

Screenshot Import

In addition to Google Calendar sync, PraxisNote can extract meeting details from a screenshot of your calendar.

1. Open the Meetings page.
2. Click Import.
3. Select the Screenshot tab.
4. Upload or paste a screenshot showing your calendar view.
5. AI analyzes the image and extracts events (title, start/end time, attendees, location).
6. Review the extracted events and select which ones to import.
7. Click Import Selected to create meetings from the selected events.

Best results

For the best extraction accuracy:

• Use a clean, uncluttered calendar view
• Make sure event titles and times are clearly visible
• Week or day view works better than month view

Tips & Best Practices

Sync calendar before meetings

Sync your Google Calendar at the start of each day or week. This pre-creates meeting entries so you can jump straight into recording when the meeting starts.

Tag imported meetings

Calendar-imported meetings don’t have tags by default. Add project or team tags right away so they appear in the Tag Hub alongside related tasks and notes.

Jira links for traceability

When discussing Jira issues in meeting notes, paste the URLs to create rich chips. This creates a traceable link between your meeting discussion and the issue tracker.