How to Connect Your Ninety Account to Claude
The Ninety MCP connector links Claude directly to your Ninety account, so you can ask about your Rocks (your 90-day priorities), Issues, To-Dos, Scorecard, meetings, Vision, and Org Chart in plain language — and have Claude create To-Dos and Issues, comment on them, update a Rock's milestones, or enter a KPI's score without opening Ninety.
Owners, Admins, Coaches, Managers, and Team Members can connect to it, while Observers cannot. You need a Ninety account on a paid subscription plan, a paid Claude plan, and to be part of Ninety's beta group to access the Claude connector.
This feature is in beta. Access is limited to members of Ninety's beta group on any paid plan, and the connector's behavior may change before general availability. When the connector reaches general availability in late September 2026, it will require the Thrive or Legacy plan. Sign up for the beta group, or learn more on the Currently in Beta at Ninety page.
What the Ninety MCP connector is
The Ninety MCP connector is a connection between Claude and your Ninety account that lets Claude read your operating data and create a limited set of items in Ninety. Instead of exporting a Scorecard or retyping meeting notes as To-Dos, you ask Claude, and it works with your live Ninety data.
What is MCP? MCP, or Model Context Protocol, is an open standard for securely connecting AI assistants to outside systems, such as your Scorecard in Ninety.
Claude is the only AI assistant supported during beta. The connector exposes 23 capabilities, called tools: 16 that read your data and 7 that write to it. Anything not on that list is never reachable, so Claude cannot act on parts of Ninety that the connector does not cover.
What you need before you connect
Confirm all four of the following before you start, because the connector will not appear or authorize without them:
A Ninety account on a paid plan. Any paid subscription plan works while the connector is in beta. The connector runs as you, so your role and team assignments determine what Claude can see.
A connecting role. Owners, Admins, Coaches, Managers, and Team Members can connect. Observers cannot.
A paid Claude plan (Pro, Max, Team, or Enterprise). Custom connectors are not available on Claude's free tier.
Beta group membership. Sign up for Ninety's beta group to be enabled.
You do not need a Personal Access Token for the connector. You authorize it in your browser instead. Ninety's Developer Settings page mentions MCP alongside Personal Access Tokens, but tokens are only for calling Ninety's API directly — see API Reference and Access.
How to connect Claude on the web or desktop
Adding the Ninety connector in Claude on the web or on Claude's desktop app takes about a minute and requires no technical setup.
In Claude, open Settings, then Connectors.
Choose the option to add a custom connector.
Name it Ninety.
Enter the server URL:
https://api.public.ninety.io/mcpAdd the connector, then click Connect.
On the Authorize Integration screen in your browser, confirm the company shown is correct, then click Authorize Integration.
Start a new chat and ask about your Scorecard or Rocks to confirm the connection works.
The authorization screen lists a broader set of permissions than the connector currently uses. Today it can create To-Dos and Issues, comment on them, add and update a Rock's milestones, and enter Scorecard scores. It cannot update or delete your Rocks, Issues, or To-Dos.
Note: A missing logo image on the authorization screen is expected during beta and does not mean anything is wrong.
Once you are connected, the Ninety connector lists the tools Claude can use, along with the connector URL and a Disconnect button. Seeing the tools listed is the clearest confirmation that the connection worked.
How to control which tools Claude can use
Claude lets you set a permission on each of the connector's tools, so you decide in advance which ones run on their own and which ones stop and ask you first. Open the Ninety connector in Claude's Connectors settings to see the full list with a control on each row.
Every tool starts out asking for your approval before it runs.
You can set any tool to run without asking, to ask every time, or to never run.
Leaving the writing tools set to ask every time is a good habit, and Put Scorecard Score especially, because entering a score replaces the value already there.
These controls are a convenience, not your protection. Ninety enforces what the connector can reach on its own servers, based on your role and team assignments, so what you are able to see and change is the same whether or not you adjust anything here.
How to connect Claude Code
Claude Code uses the same connector, added from the command line. This path is intended for more technical users.
Run:
claude mcp add --scope user --transport http ninety https://api.public.ninety.io/mcp --callback-port 3118Type
/mcp, choose ninety, and approve access in your browser.Restart Claude Code so the Ninety tools load, then confirm the tools appear.
If you would rather be walked through it, paste this into Claude Code: Connect me to my Ninety account via its MCP server at https://api.public.ninety.io/mcp. Walk me through it one step at a time and wait for me at each step.
How to connect more than one company
Each Ninety connector is tied to one company, chosen on the Authorize Integration screen when you connect. If you belong to more than one company in Ninety — a coach working with several client companies, or a leader running more than one business — add a separate connector for each company. There is no limit on how many you can have connected at once.
Claude will not save two connectors that use the same server URL, so make each URL slightly different by adding a question mark to the end. The connection still points to the same place and works the same way.
Add a second custom connector in Claude, following the same steps you used for the first.
Name it so you can tell your connections apart, such as Ninety – Acme Co.
Enter the server URL with a question mark at the end:
https://api.public.ninety.io/mcp?Click Connect, then choose the correct company in the Company dropdown on the Authorize Integration screen before you click Authorize Integration.
For a third company or more, add a number after the question mark to keep each URL unique, such as
https://api.public.ninety.io/mcp?3.
Naming each connector after its company matters more than it looks. Claude shows you the connector name, not the company behind it, so clear names are how you know which company a question is being answered from.
What you can ask Claude to read
Claude can read the Ninety data that your role and teams already give you access to.
These are some questions the connector answers well:
Area | What Claude can read | Example prompt |
Rocks | Rocks filtered by team, owner, status, level, or quarter, plus one Rock in full with its milestones. | What Rocks are off track this quarter? |
Issues | Short-term and long-term Issues by team, or by search text. | Summarize our open Issues. |
To-Dos | Your own To-Dos, and a teammate's team To-Dos, filtered by due date or status. | What To-Dos do I have due this week? |
Scorecard | KPI details (name, goal, owner, cadence, teams) and the actual scores for a span of periods. | Which KPIs were off track the last four weeks? |
Next meeting | A team's next meeting: time, cadence, presenter, scribe, the ordered agenda with durations, and attendees. | What's on the agenda for my next Leadership Team meeting? |
Past meetings | A team's meeting history with ratings, length, and issue solve rate, plus one meeting in full: its notes and the Issues, To-Dos, Rocks, and Headlines it produced. | What did we decide in our last three weekly meetings? |
Vision | Core Values, Purpose, and Niche from the Vision page, plus the 1-year and 3-year goals from the Strategy page — for your team and for the leadership team. | What are our company's Core Values? |
Org Chart | Every Seat, what it is accountable for, who holds it, and who reports to whom. | Who owns customer onboarding? |
Teams and people | The teams you can work with and the people in your company. | Which teams am I on? |
Note: A few of the connector's tool names in Claude use EOS wording. Get a team's V/TO reaches your Vision and Strategy pages, and Measurable means a KPI. They return the same data you see in Ninety.
What Claude can create and update
The connector can write to Ninety in seven ways. Everything else is read-only.
Create a To-Do. Leave the team off for a personal To-Do, or name a team for a team To-Do. You can assign up to 10 people, which creates a separate To-Do for each person.
Create an Issue. Files a new Issue on a team with a priority from 0 to 5 and exactly one owner.
Enter a KPI's score. Records a score for one KPI in the period containing the date you give, with an optional note.
Add a milestone to a Rock. Creates a milestone with a title and due date, owned by you.
Update or complete a milestone. Changes a milestone's title, description, due date, or owner, or marks it done.
Comment on an Issue. Adds a comment to an Issue under your name.
Comment on a To-Do. Adds a comment to a To-Do under your name.
Important: Comments post publicly under your name and notify everyone following the item, exactly as if you had typed them in Ninety. They cannot be edited or deleted afterward, so check the wording before you ask Claude to post one.
Try this: Paste a meeting recording transcript into Claude and ask it to create the To-Dos from it in Ninety. Claude looks up the right team and people, then files each one.
How far back Claude can read your Scorecard
Claude reads the most recent 13 periods of a Scorecard by default, and it can pull a wider span when you ask for one. You can request quarter-to-date, year-to-date, the current quarter, the current fiscal year, or a single period by naming a date.
For example, asking a weekly Scorecard for year-to-date data in August returns every week since the start of the fiscal year, not just the last 13. Weekly Scorecards support all those spans; quarterly Scorecards support the default span, year-to-date, and the current year; annual Scorecards support the default span only.
There is no way to request a custom date range or history from earlier fiscal years. For anything further back, export the Scorecard from Ninety instead.
What the connector can't do yet
The connector covers Scorecards, Rocks, Issues, To-Dos, meetings, your Vision, and the Org Chart. Knowing the gaps up front saves you from asking Claude for something it cannot reach:
Headlines, 1-on-1, and the Knowledge Portal are not available. Claude can see the Headlines a past meeting closed, but it cannot read or create Headlines on its own.
Rocks themselves are read-only. Claude can report on a Rock and add or complete its milestones, but it cannot create a Rock, edit one, or change its status.
No update or delete for Issues or To-Dos. Claude can file an Issue but not close one, and create a To-Do but not complete it.
No creating KPIs. Claude can read a KPI and enter its score, but it cannot create a new one.
No meeting recap. Claude can read a past meeting's notes and the items it produced, but not the meeting recap itself.
Comments are permanent. Once Claude posts a comment, it cannot be edited or deleted.
One company per connection. A single connector reaches one company, so belonging to several companies means adding a connector for each.
Web only. The connect flow is web-based; there is no iOS or Android setup.
To make those changes, work in Ninety directly, or use Ask Maz, which can edit existing Rocks, To-Dos, Issues, Headlines, and Org Chart Seats.
Before you let Claude enter a Scorecard score
Entering a score is the one connector action that can replace existing data, so it is worth understanding before you use it.
Warning: Writing a score overwrites whatever score is already recorded for that KPI and period, without first warning you. Because each company sets its own week start day, a date that falls on a period boundary can land in the neighboring period, and no error is shown. Give Claude a date in the middle of the week you mean.
How security and permissions work
The connector runs as you, which is the most important thing to understand about its security. It authenticates with your own Ninety login, so it can only ever see and do what you can already see and do in Ninety.
Your permissions apply. Your role and team assignments govern every call. See User Roles and Permissions.
You approve access. Nothing connects until you authorize it in your browser.
You can disconnect anytime. Access ends as soon as you do.
Your name is on what Claude creates. To-Dos, Issues, milestones, and comments the connector adds are recorded as yours.
Private To-Dos stay private. They are never returned to the connector.
Only published tools are reachable. New capability in Ninety's API does not silently become a new capability for Claude.
Connecting Claude sends Ninety data to Claude, and data that reaches Claude is governed by the terms and privacy policy of your Claude plan, not by Ninety. Review those terms before connecting, especially for how your Claude plan handles retention and model training.
For how Ninety handles your data, see Ninety's Privacy Policy, Terms of Service, and Trust Center.
Choosing between Claude, Maz, and Zapier
The connector is not the only way to work with your Ninety data through AI or automation, and it is often not the fastest one. Use this to pick the right path:
Option | Use it when | Worth knowing |
Maz, built into Ninety | You want AI help inside Ninety with no setup and no outside account. | Interprets your data through a best-practice lens and can edit existing items, including Rocks, Seats, and Headlines. Your data stays with Ninety and its contracted providers. |
The Claude connector | You want to reason about Ninety data alongside files, notes, and other systems in a single Claude conversation. | Requires a paid Claude plan and beta access. Reads broadly, writes narrowly. |
Zapier | You want scheduled, hands-off automation between Ninety and another app. | No-code, with pre-built recipes and its own MCP option. Runs per account and counts against a task quota. See Connecting Ninety to Zapier. |
Many teams use more than one. A common pattern is Zapier for the weekly Scorecard update, Maz for in-app work, and Claude for one-off analysis spanning several systems.
How to disconnect the connector
You can remove the Ninety connector at any time, and Claude loses access immediately.
Claude on the web or desktop: open Settings, then Connectors, select Ninety, and click Disconnect.
Claude Code: run
claude mcp remove ninety
Troubleshooting
Issue: Claude doesn't see your Ninety tools after you connect.
Solution:
Restart Claude, or restart Claude Code if you connected there.
Open the Ninety connector and confirm the tools are listed.
Start a new chat, since an existing chat may not pick up a newly added connector.
Issue: Claude has the connector but won't use a particular tool.
Solution: Open the Ninety connector in Claude's Connectors settings and check that tool's permission. A tool set never to run is skipped, and a tool set to ask waits for your approval before it does anything.
Issue: You don't see an option to add a custom connector in Claude.
Solution: Custom connectors require a paid Claude plan (Pro, Max, Team, or Enterprise). Claude's free tier does not include them.
If you're on a Claude Team or Enterprise plan, your administrator may have blocked custom connectors. Reach out to your IT department for more information.
Issue: The authorization screen shows a broken or missing logo.
Solution: This is expected during beta. The connection still works, and it is safe to authorize.
Issue: Claude can't find a team, a person, or the data you expect to be there.
Solution:
Confirm you can see the same data in Ninety yourself, since the connector runs as you.
Check that you are assigned to the team in question.
Ask Claude to look the team up again, because it matches teams and people by their record in Ninety rather than by name alone.
Confirm the person is still active, as deactivated users are not returned.
Issue: A score landed in the wrong week.
Solution: Your company's week start day determines where a date falls. Ask Claude to enter the score again using a date in the middle of the week you intended, then confirm the value in the Scorecard.
Issue: You can't connect at all.
Solution: Confirm you are in the beta group, that your Ninety role is not Observer, and that your company is on a paid plan. If all three are true and it still fails, contact support.
Frequently asked questions
Which plans include the Claude connector?
While the connector is in beta, it is available to members of Ninety's beta group on any paid plan — Essentials, Accelerate, Thrive, or Legacy. When it reaches general availability in late September 2026, it will require the Thrive or Legacy plan. The Free plan does not include the connector at any stage.
Can I connect ChatGPT or another AI assistant to Ninety?
Not yet. Claude is the only assistant supported while the connector is in beta. Support for other assistants may follow.
Do I need a Personal Access Token to use the Claude connector?
No. You authorize the connector in your browser. Personal Access Tokens are only needed to call Ninety's API directly, as described in API Reference and Access.
Can Claude create a KPI or a Rock?
No. Claude can read your KPIs and enter their scores, but it cannot create a new KPI. It can read your Rocks and add or complete their milestones, but it cannot create a Rock or change one. Create both in Ninety directly.
Can Claude delete my Ninety data?
No. The connector cannot delete anything. It can create To-Dos, Issues, milestones, and comments, and enter Scorecard scores. Entering a score replaces the value already recorded for that KPI and period, and a comment cannot be removed once it is posted.
Can Claude see other teams' data?
Only the teams you can already see in Ninety. Owners, Admins, and Coaches can reach every non-private team in the company, so the connector reflects that same access.
Does this replace Maz?
No. Maz is built into Ninety, needs no setup, and can edit existing items that the connector cannot touch. The connector is for working with Ninety data inside Claude alongside your other tools and files.
Can my whole team use the connector?
Each person connects their own Claude account, and each connection runs as that person. Teammates need to join the beta group to be enabled.
Can I connect Claude to more than one company?
Yes. Each connector reaches one company, and you can have several connected at once — one per company. Because Claude will not save two connectors with the same server URL, add a question mark to the end of the URL for each additional one, and name each connector after its company.
Does the connector work on the Ninety mobile app?
No. Connecting and using the connector is web-based only.