Setup guide
Connect Linear
Linear connects through OAuth 2.0. You authorize Modiva from Linear's own consent screen and pick the workspace to connect — Modiva then reads and writes issues, projects, teams and comments through one unified API and MCP server, all over Linear's GraphQL API. Linear access tokens expire every 24 hours; Modiva refreshes them automatically so your connection stays healthy without you reconnecting. Enable webhooks on the app to receive real-time events when issues, comments or projects change.
Before you start
- A Linear workspace, and access to the workspace you want to connect.
- Permission in that workspace to authorize a third-party OAuth application.
Step-by-step setup
- 1
Sign in to Modiva
Log in at modiva.ai and open the Dashboard. You need a Modiva account before you can connect any platform — creating one takes a minute and no credit card is required for the free tier.
- 2
Open Connections → New connection
In the left sidebar choose Connections, then click New connection. You'll see the full catalogue of platforms grouped by category (Social, Ads, CRM, E-commerce and Productivity).
- 3
Select Linear
Click the Linear card. Modiva redirects you to Linear's official sign-in and permission screen — your password is entered on Linear, never on Modiva.
- 4
Authorize Modiva on Linear
Review the read and write permissions Modiva is requesting and approve them. If you belong to more than one workspace, pick the Linear workspace you want Modiva to connect.
- 5
You're connected
Linear sends you back to Modiva and the connection appears with a green Connected status. From here it's available to every MCP key and API call in your workspace.
Permissions Modiva requests
When you connect Linear, Modiva asks only for the access it needs to run the tools you use. You can revoke it any time from Linear’s API settings or by disconnecting in Modiva.
- Read your workspace identity
- Read and write issues
- Read and write projects and comments
- Read teams
- Stay connected by refreshing access tokens
Troubleshooting & FAQ
Where is my Linear password stored?
Nowhere. You sign in on Linear's own site and Modiva only receives a scoped access token, which is encrypted at rest with AES-256-GCM. Modiva never sees your password.
Which Linear workspace gets connected?
The workspace you're signed into when you approve the consent screen. If you belong to several Linear workspaces, switch to the one you want before authorizing.
How do priorities work?
Linear priorities are 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low. Pass the numeric value when creating or updating an issue.
My token keeps needing refresh — is that a problem?
No. Linear access tokens expire about every 24 hours by design. Modiva stores a refresh token and renews access automatically in the background, so you won't be asked to reconnect unless you revoke access in Linear.
Can I receive real-time events from Linear?
Yes. Modiva exposes a signed webhook endpoint at /api/webhooks/linear. Enable webhooks on the Linear app and set that as the Webhook URL; Modiva verifies each event's signature and forwards issue, comment and project changes to your registered webhook endpoints.
How do I disconnect?
Open Connections, click the Linear row and choose Disconnect. Modiva deletes the stored token immediately. You can also revoke Modiva from inside Linear's API settings.
Need help with Linear?
Reach the team any time from our support page, or ask Fin, our AI support agent.