Overview
The NimbleWork MCP Connector lets you use AI assistants to interact with your Nimble workspaces using natural language — creating workitems, updating cards, managing todos, logging time, and more — without leaving your AI tool.
This article explains how to connect the NimbleWork connector on any supported AI platform and how to use it to perform common actions. The steps below use Claude (Anthropic) as the example platform, but the same connection flow applies to other supported platforms including Grok, Gemini, OpenAI, and Microsoft Copilot.
Prerequisites
- An active Nimble account with access to the workspace(s) you want to work with.
- Access to a supported AI platform — Claude, Grok, Gemini, OpenAI, or Microsoft Copilot.
Connect the NimbleWork Connector
The connection process is the same across all supported AI platforms. The steps below show the flow using Claude as an example.
- Open your AI platform and go to Settings.
- Select Connectors (or Integrations / Extensions, depending on the platform).
- Search for NimbleWork and select it from the results.
- Click Add (or Install / Enable).
- Click Connect. Your browser opens the Nimble login page.
- Sign in with your Nimble account credentials.
- An authorization screen appears listing the access the connector is requesting. Review it and click Authorize (or Allow).
- You are returned to your AI tool. The NimbleWork connector now shows as Connected.
Note: Your Nimble credentials are never stored by the AI platform. The connector uses a secure OAuth authorization flow — your password is shared only with Nimble, and the AI tool receives a time-limited access token.
What You Can Do
The NimbleWork connector works with your Nimble Workitems (cards) and the items on them — it does not cover everything you can do in Nimble. Once connected, you can use natural language to:
- Find and read — list your projects and workspaces and their card types; read Workitems and their ToDos, comments, attachments, and linked Workitems.
- Create and update Workitems — create a Workitem, update its details, and close, reopen, or delete it.
- Manage ToDos and time — add ToDos to a Workitem, assign and update them, close, reopen, or delete them, and log time.
- Act on Workitems — flag, block, or vote on a Workitem (and undo each); link or unlink Workitems (for example, as parent and child); add a comment; or attach a file.
- Switch context — select the project or workspace to work in.
Tip: If your prompt does not specify a workspace and you have access to more than one, the AI assistant will ask you to choose before taking any action — so your changes always land in the right place.
Available Tools
The connector exposes the same set of tools on every supported AI platform — 31 in total, grouped into read-only tools and write/delete tools. Read-only tools only retrieve information; write/delete tools make changes. Most AI assistants ask for your approval before a tool runs, and typically let you allow an action once or always allow it.
Read-only tools (9): List Workspaces, List Forms, List User Forms, Get Form, List Cards, Get Linked Cards, List Todos, Get Comments, Get Attachments.
Write/delete tools (22): Create Card, Update Card, Close Card, Reopen Card, Delete Card, Flag Card, Unflag Card, Block Card, Unblock Card, Vote on Card, Remove Vote from Card, Link Card, Unlink Card, Add Todo, Update Todo, Close Todo, Reopen Todo, Delete Todo, Log Time, Add Comment, Add Attachment, Select Workspace.
Example Actions
The examples below show natural language prompts you can type and what the connector does in response.
1. List your workspaces
Prompt: “List all the workspaces I have access to.”
What happens: The connector returns the names and IDs of all workspaces accessible to your account. Use this to confirm which workspace you want to work in before creating or updating workitems.
2. Create a workitem
Prompt: “Create a user story in the Feature Development project named ‘Design for Mobile login page’.”
What happens: The connector creates a new card in the specified workspace and form, and returns its ID (e.g., FF21) and a confirmation. You can include additional fields such as priority, description, estimate, or due date in your prompt.
3. Update a workitem
Prompt: “Update FF21 — set the description to describe the mobile login mockups and set the estimate to 6 hours.”
What happens: The connector updates only the fields you specify (description and EstimateHours) on FF21. All other fields remain unchanged.
4. Add a todo and log time
Prompt: “Add a todo to FF21 called ‘Create wireframes’ with an estimate of 3 hours, then log 2 hours of work against it.”
What happens: The connector creates the todo on FF21 and logs 2 hours of actual effort against it in a single conversation — no switching between tools required.
Important Points
- Always mention the workspace/project name in your prompt when working across multiple workspaces to avoid ambiguity.
- The connector respects your Nimble roles and permissions. You can only view and change the workspaces, forms, and workitems that your Nimble account already has access to — connecting does not grant any additional access.
- Comments, attachments, and other changes you make through the connector are recorded under your own Nimble user account.
- If the connector loses its connection (token expired or revoked), you can reconnect by going to Settings > Connectors in your AI platform and clicking Reconnect.
- To disconnect, go to Settings > Connectors in your AI platform and remove the NimbleWork connector. You can also revoke access from your Nimble account settings.