Integration · Projects & tasks

Connect Claude & ChatGPT to vPlan

Ask your AI what is planned for next week, which cards are late, or to move a job to another day. It reads boards, collections, cards, resources, orders and time entries in vPlan, and can create collections, cards, orders, projects and relations. It can also reschedule cards and log time, so the planning board stays current without clicking through it.

Connect vPlan free

Free plan, no credit card. Takes about a minute.

Try asking

“What is planned on the Installation board next week?”
The AI searches cards on that board with start dates in next week and lists them with stage and status.
“Move the Hansen kitchen job to Thursday.”
It finds the card and updates its start and end dates. The other fields stay as they are.
“Create a job for the new Jensen order, due on the 30th, with an assembly card.”
It creates a collection with the due date and adds a card to it.

What your AI can do

Planning

Read boards, collections and cards, search cards across boards, create collections and cards, and reschedule or move cards.

Orders and relations

List and create orders with rows, look up items, and search, create and update customers and suppliers.

Time and resources

Log and list time entries, and see activities, resources, users and projects.

“Log 3 hours of installation on the Hansen card for Peter today.”
It looks up the activity and user and creates a draft time entry on the card.
“Add a sales order for Nordic Foods with two order rows.”
It finds the relation and the items and creates the order with the rows.
“Which resources do we have for planning?”
It lists people, machines and teams that work can be planned on.

138 tools for vPlan

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

add_collection_commentChanges dataPost a comment `text` on a collection by `collection_id`. Mentioned users (`user_mentions`) are notified.
create_boardChanges dataCreate a new board. API summary: Create Board.
create_board_checklistChanges dataCreate a new checklist for a board. API summary: Create Checklist.
create_board_viewChanges dataCreate a new view for a board. Required: type or name. API summary: Create New BoardView.
create_cardChanges dataAdd a card to a collection by `collection_id` with a `name`, and optionally `start_date`/`end_date` (and times), `stage_id`, `status_id` and `description`.
create_card_checklistChanges dataCreate a new checklist for a card. API summary: Create New Card Checklist.
create_card_relationChanges dataCreate a new card relation. Required: type, related card id or card id. API summary: Create New CardRelation.
create_category_checklistChanges dataCreate a new checklist for a category. API summary: Create New Collection Checklist.
create_category_documentChanges dataCreate a new document for a category. Required: filename or file. API summary: Add New Attachment Link.
create_collectionChanges dataCreate a collection (a job or work item to plan) with a `name`, optional `board_id`, `due_date`, `description`, `status` (planned, not_planned, ignored) and custom fields.
create_groupChanges dataCreate a new group. Required: name. API summary: Create New Group.
create_new_orderrowChanges dataCreate a new order for a order. Required: description or unit. API summary: Create New OrderRow.
create_orderChanges dataCreate an order with a `code`, `type` (Production, Project, Purchase, Quotation, Sales) and `description`. Optionally link a `relation_id`, `project_id` or `board_id`, set dates and add `order_rows`.
create_productChanges dataCreate a new product. Required: description or code. API summary: Create New Item.
create_projectChanges dataCreate a project with a `name` and optional `code` and `description`. Search first to avoid duplicates.
create_relationChanges dataCreate a relation (customer or supplier) with a `name` and optional `type`, `email`, `phone`, `website` and notes. Search first to avoid duplicates.
create_resourceChanges dataCreate a new resource. Required: name or type. API summary: Create New Resource.
create_resource_schedule_deviationChanges dataCreate a new schedule deviation for a resource. API summary: Create New Schedule Deviation.
create_spaceChanges dataCreate a new space. Required: name. API summary: Create New Space.
create_stageChanges dataCreate a new stage. Required: name. API summary: Create Stage.
create_taskChanges dataCreate a new task. Required: description. API summary: Create Activity.
create_time_entryChanges dataLog time with a `start` (and `end` or `duration`), optionally on a `card_id` and `activity_id` for a `user_id`, with a note. Status defaults to draft.
create_userChanges dataCreate a new user. Required: email, role or resource. API summary: Invite User.
create_warehouseChanges dataCreate a new warehouse. Required: name. API summary: Create New Warehouse.
create_webhookDeletesCreate a new webhook. Required: url. Search webhooks first to avoid duplicates. Destructive action; may require approval. API summary: Create New Webhook.
delete_boardDeletesPermanently delete a board by board id. Destructive action; may require approval. API summary: Remove Board.
delete_board_checklistDeletesPermanently delete a checklist by checklist id. Destructive action; may require approval. API summary: Remove Checklist.
delete_card_checklistDeletesPermanently delete a checklist by checklist id. Destructive action; may require approval. API summary: Remove Single Card Checklist.
delete_card_custom_fieldDeletesPermanently delete a custom field by name. Destructive action; may require approval. API summary: Delete Custom Field By Name.
delete_card_relationDeletesPermanently delete a card relation by card relation id. Destructive action; may require approval. API summary: Remove Single CardRelation.
delete_categoryDeletesPermanently delete a category by category id. Destructive action; may require approval. API summary: Remove Single Collection.
delete_category_cardDeletesPermanently delete a card by card id. Destructive action; may require approval. API summary: Remove Single Card.
delete_category_checklistDeletesPermanently delete a checklist by checklist id. Destructive action; may require approval. API summary: Remove Single Collection Checklist.
delete_category_custom_fieldDeletesPermanently delete a custom field by name. Destructive action; may require approval. API summary: Delete Custom Field By Name.
delete_category_documentDeletesPermanently delete a document by document id. Destructive action; may require approval. API summary: Remove Single Attachment.
delete_category_messageDeletesPermanently delete a message by message id. Destructive action; may require approval. API summary: Remove Single Comment.
delete_groupDeletesPermanently delete a group by group id. Destructive action; may require approval. API summary: Remove Single Group.
delete_orderDeletesPermanently delete a order by order id. Destructive action; may require approval. API summary: Remove Single Order.
delete_productDeletesPermanently delete a product by product id. Destructive action; may require approval. API summary: Remove Single Item.
delete_projectDeletesPermanently delete a project by project id. Destructive action; may require approval. API summary: Remove Single Project.
delete_relationDeletesPermanently delete a relation by relation id. Destructive action; may require approval. API summary: Remove Single Relation.
delete_resourceDeletesPermanently delete a resource by resource id. Destructive action; may require approval. API summary: Remove Single Resource.
delete_resource_schedule_deviationDeletesPermanently delete a schedule deviation by schedule deviation id. Destructive action; may require approval. API summary: Remove Single Schedule Deviation.
delete_spaceDeletesPermanently delete a space by space id. Destructive action; may require approval. API summary: Remove Single Space.
delete_stageDeletesPermanently delete a stage by stage id. Destructive action; may require approval. API summary: Remove Stage.
delete_taskDeletesPermanently delete a task by task id. Destructive action; may require approval. API summary: Remove Activity.
delete_time_trackingDeletesPermanently delete a time tracking by time tracking id. Destructive action; may require approval. API summary: Remove Single TimeTracking.
delete_warehouseDeletesPermanently delete a warehouse by warehouse id. Destructive action; may require approval. API summary: Remove Single Warehouse.
delete_webhookDeletesPermanently delete a webhook by webhook id. Destructive action; may require approval. API summary: Remove Single Webhook.
export_time_trackingsExport time trackings. API summary: Export TimeTracking.
get_boardGet one planning board by `board_id`.
get_board_checklistGet one checklist for a board by checklist id. API summary: Retrieve Checklist.
get_cardGet one card by `collection_id` and `card_id`, with dates, stage and status.
get_card_checklistGet one checklist for a card by checklist id. API summary: Retrieve Single Card Checklist.
get_card_relationGet one card relation by card relation id. API summary: Retrieve Single CardRelation.
get_category_checklistGet one checklist for a category by checklist id. API summary: Retrieve Single Collection Checklist.
get_category_documentGet one document for a category by document id. API summary: Retrieve Single Attachment.
get_category_messageGet one message for a category by message id. API summary: Retrieve Single Comment.
get_collectionGet one collection by its ID (`category_id`), with its status, board, due date, description and custom fields.
get_current_userGet information about the connected vPlan user and account. Use to confirm which account you are working in.
get_groupGet one group by group id. API summary: Retrieve Single Group.
get_orderGet one order by `order_id`.
get_productGet one product by product id. API summary: Retrieve Single Item.
get_projectGet one project by `project_id`.
get_relationGet one relation (customer or supplier) by `relation_id`.
get_resourceGet one resource by resource id. API summary: Retrieve Single Resource.
get_resource_scheduleGet one schedule for a resource by year. Results are paginated. API summary: Retrieve Schedule Year.
get_resource_schedule_deviationGet one schedule deviation for a resource by schedule deviation id. API summary: Retrieve Single Schedule Deviation.
get_resource_schedule_getGet one schedule for a resource by day. Results are paginated. API summary: Schedule Retrieve Day.
get_spaceGet one space by space id. API summary: Retrieve Single Space.
get_stageGet one stage by stage id. API summary: Retrieve Stage.
get_taskGet one task by task id. API summary: Retrieve Activity.
get_time_trackingGet one time tracking by time tracking id. API summary: Retrieve Single TimeTracking.
get_userGet one user by user id. API summary: Retrieve Single User.
get_warehouseGet one warehouse by warehouse id. API summary: Retrieve Single Warehouse.
get_webhookGet one webhook by webhook id. API summary: Retrieve Single Webhook.
list_activitiesList activities (the types of work that can be planned and tracked, e.g. assembly or installation).
list_board_checklistsList checklists for a board. Optional filters: with.
list_boardsList planning boards with their IDs. Set `with` to include stages, collections or cards.
list_card_checklistsList checklists for a card. API summary: Retrieve Card Checklist List.
list_card_relationsList card relations. Optional filters: with. API summary: Retrieve CardRelation List.
list_category_checklistsList checklists for a category. API summary: Retrieve Collection Checklist List.
list_category_documentsList documents for a category. Optional filters: with. API summary: Retrieve Attachment List.
list_collection_cardsList the cards of one collection by `collection_id`.
list_collection_commentsList the comments on a collection by `collection_id`.
list_collectionsList collections (the jobs or work items you plan, each holding one or more cards). Set `with` to include cards, checklists, comments and more.
list_groupsList groups. Optional filters: date range start, date range end or time frame. API summary: Capacity Group.
list_itemsList items (products and materials) with their IDs, for use on orders.
list_messagesList messages. API summary: Retrieve Api Messages.
list_ordersList orders (sales, purchase, production, project or quotation). Set `with` to include order rows, the item or the relation.
list_resource_schedule_deviationsList schedule deviations for a resource. Optional filters: with. API summary: Retrieve Deviation List.
list_resourcesList resources (people, machines, teams) that work can be planned on. Set `with` to include their cards or schedules.
list_resources_2List resources. Optional filters: date range start, date range end or time frame. API summary: Capacity Resource.
list_spacesList spaces. Optional filters: with. API summary: Retrieve Space List.
list_stagesList stages. Optional filters: date range start, date range end, time frame or stage id. API summary: Capacity Stage.
list_stages_2List stages. Optional filters: with.
list_stages_getList stages. Optional filters: date range start, date range end or time frame. API summary: Capacity Resource Type Stage.
list_time_entriesList time tracking entries.
list_usersList vPlan users with their IDs. Set `archived` to include archived users.
list_warehousesList warehouses. API summary: Retrieve Warehouse List.
remove_single_orderrowDeletesPermanently delete a order by order id 2. Destructive action; may require approval. API summary: Remove Single OrderRow.
retrieve_group_listList groups. Optional filters: with. API summary: Retrieve Group List.
retrieve_orderrow_listList orders for a order. Optional filters: with. API summary: Retrieve OrderRow List.
retrieve_schedule_monthGet one schedule for a resource by month. Results are paginated. API summary: Retrieve Schedule Month.
retrieve_single_orderrowGet one order for a order by order id 2. API summary: Retrieve Single OrderRow.
search_cardsSearch cards (planned pieces of work on boards) across all collections, with `filter` and `sort` expressions, `limit`/`offset` paging and `with` to include stage, resources, activities, time tracking or relations.
search_projectsSearch projects with `filter` and `sort` expressions and `limit`/`offset` paging.
search_relationsSearch relations (customers and suppliers) with `filter` and `sort` expressions and `limit`/`offset` paging. Use to find a relation ID before creating one.
search_resource_schedulesSearch schedules for a resource by filter, sort, show or hide. Use this to find existing schedules before creating a new schedule. Results are paginated. API summary: Retrieve Schedule List.
search_webhooksSearch webhooks by with, filter, sort, show or hide. Use this to find existing webhooks before creating a new webhook. Results are paginated. API summary: Retrieve Webhook List.
submit_cardVisible to othersSplit a card (card id). Has effects visible outside this system. API summary: Split Card.
update_boardChanges dataUpdate an existing board identified by board id. API summary: Update Board.
update_board_checklistChanges dataUpdate an existing checklist identified by checklist id. API summary: Update Checklist.
update_cardChanges dataUpdate a card by `collection_id` and `card_id`: reschedule it (start/end dates and times), move it to another `stage_id` or `status_id`, or rename it. Only the fields you pass change.
update_card_checklistChanges dataUpdate an existing checklist identified by checklist id. API summary: Update Single Card Checklist.
update_card_custom_fieldChanges dataUpdate an existing custom field identified by name. API summary: Update Custom Field By Name.
update_categoryChanges dataUpdate an existing category identified by category id. API summary: Update Single Collection.
update_category_backlogsVisible to othersUpdate an existing backlog identified by collection id. Has effects visible outside this system. API summary: Move Collection to Backlog.
update_category_boardChanges dataUpdate an existing board identified by board id. API summary: Move Collection to Board.
update_category_checklistChanges dataUpdate an existing checklist identified by checklist id. API summary: Update Single Collection Checklist.
update_category_custom_fieldChanges dataUpdate an existing custom field identified by name. API summary: Update Custom Field By Name.
update_category_messageChanges dataUpdate an existing message identified by message id. API summary: Update Single Comment.
update_groupChanges dataUpdate an existing group identified by group id. API summary: Update Single Group.
update_orderChanges dataUpdate an existing order identified by order id. API summary: Update Single Order.
update_productChanges dataUpdate an existing product identified by product id. API summary: Update Single Item.
update_projectChanges dataUpdate a project's name, code or description by `project_id`. Only the fields you pass change.
update_relationChanges dataUpdate a relation by `relation_id`: name, type, email, phone, website or notes. Only the fields you pass change.
update_resourceChanges dataUpdate an existing resource identified by resource id. API summary: Update Single Resource.
update_resource_schedule_deviationChanges dataUpdate an existing schedule deviation identified by schedule deviation id. API summary: Update Single Schedule Deviation.
update_resource_schedulesVisible to othersUpdate an existing schedule identified by resource id. Has effects visible outside this system. API summary: Bulk update schedule.
update_single_orderrowChanges dataUpdate an existing order identified by order id 2. API summary: Update Single OrderRow.
update_spaceChanges dataUpdate an existing space identified by space id. API summary: Update Single Space.
update_stageChanges dataUpdate an existing stage identified by stage id. API summary: Update Stage.
update_taskChanges dataUpdate an existing task identified by task id. API summary: Update Activity.
update_time_trackingChanges dataUpdate an existing time tracking identified by time tracking id. API summary: Update Single TimeTracking.
update_userChanges dataUpdate an existing user identified by user id. API summary: Update Single User.
update_warehouseChanges dataUpdate an existing warehouse identified by warehouse id. API summary: Update Single Warehouse.
update_webhookDeletesUpdate an existing webhook identified by webhook id. Destructive action; may require approval. API summary: Update Single Webhook.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose vPlan from the app list.
2
Paste your key
Paste your vPlan API key and the environment ID (Api-Env) that belongs to it. In vPlan open Settings in the side menu, click API Keys and then ADD KEY. vPlan recommends replacing API keys at least every 6 months.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in vPlan?

The AI can read boards, collections, cards, comments, orders, items, relations, projects, activities, resources, users and time entries. It can create collections, cards, orders, projects, relations and time entries, post comments, and update cards, projects and relations.

Does the AI see my vPlan credentials?

No. Your vPlan credentials are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start with reading the plan only. Rescheduling a card, creating an order or posting a comment that notifies colleagues can require your approval before it runs. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT, open Settings › Apps & Connectors › Advanced, turn on Developer mode and add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own vPlan account.

What is the Api-Env environment ID?

When you add an API key in vPlan under Settings › API Keys, it comes with an environment identifier called Api-Env. HeyMyApps sends both with every call, so paste the key and its Api-Env together. vPlan recommends replacing the key at least every 6 months.