Summary
Let your AI work with your sipgate phone system: the history of calls, voicemails, SMS and faxes, users, devices, phone numbers, forwardings and groups, the address book, calls in progress and the balance. Sending SMS and starting calls are included but switched off. Personal access token.
Guided setup
Connect sipgate to Gemini in 2 minutes
Start a free trial on AnythingMCP Cloud, connect sipgate in the guided setup, then add your MCP URL to Gemini. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
Try asking
Example prompts for sipgate
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → sipgate, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
sipgate + Gemini
Let your AI work with your sipgate phone system: the history of calls, voicemails, SMS and faxes, users, devices, phone numbers, forwardings and groups, the address book, calls in progress and the balance. Sending SMS and starting calls are included but switched off. Personal access token.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
SIPGATE_TOKEN_ID, SIPGATE_TOKEN
Step 1 — Get credentials
Setting up takes about 3 minutes.
- Sign in at https://app.sipgate.com and open https://app.sipgate.com/personal-access-token (in the menu: your user, Personal access tokens).
- Create a token, give it a name and tick the scopes you need (list below). sipgate shows a Token ID (it looks like
token-AB12CD) and the token itself (a long code), the token only once. - Paste the Token ID into
SIPGATE_TOKEN_IDand the token intoSIPGATE_TOKEN. They are sent as HTTP Basic credentials (Token ID as user name, token as password).
Scopes to tick (read scopes are enough for every tool that is switched on, except notes and new contacts)
- Always useful:
account:read,balance:read,users:read,devices:read,numbers:read,phonelines:read,phonelines:forwardings:read. - History:
history:read;history:writefor notes, stars and archiving. - Address book:
contacts:read;contacts:writeto add contacts. - Others:
voicemails:read,blacklist:read,groups:read,groups:users:read,rtcm:read(calls in progress),sms:read. - Only if you switch the paid tools on:
sessions:sms:write(send SMS) andsessions:calls:write(start calls). A call that needs a scope the token does not have answers 403.
Where to start: sipgate_get_user_info checks the token and returns your user id (sub, e.g. w0). sipgate_list_history is the call list; sipgate_list_users and sipgate_list_numbers show how the account is set up.
Account: sipgate_get_account, sipgate_get_balance, sipgate_list_users, sipgate_get_user, sipgate_list_devices, sipgate_get_device, sipgate_list_numbers, sipgate_list_user_numbers, sipgate_list_phonelines, sipgate_list_forwardings, sipgate_list_groups, sipgate_list_group_users, sipgate_list_blocklist.
Calls and messages: sipgate_list_history (filter by type, direction, time and number), sipgate_get_history_entry, sipgate_update_history_entry (note, read, star, archive), sipgate_list_active_calls, sipgate_list_voicemails (the boxes; the messages are history entries of type VOICEMAIL).
Address book: sipgate_list_contacts, sipgate_get_contact, sipgate_create_contact.
Paid actions, switched off at install: sipgate_send_sms (needs the id from sipgate_list_sms_extensions) and sipgate_start_call.
Field notes
- Ids are a letter and a number: users
w0, VoIP phonese0, mobile devicesy0, external devicesx0, phone linesp0, groupsg0, SMS extensionss0, voicemail boxesv0, fax linesf0. - Phone numbers are in international format with
+(e.g.+4915799912345). - Times in the history are ISO 8601 in UTC. sipgate keeps the history only as long as the plan says (
historyLifeTimeof the account: none, 30 days or unlimited). - The balance amount is in ten-thousandths: divide by 10000 to get euros or pounds.
- A token sees what its user sees. Entries of other users (
include_all_users) and the full user list need an administrator. - sipgate throttles clients that poll quickly; ask for a filtered page of the history instead of reading everything again.
- Not covered: changing forwardings, devices or numbers, fax sending, and the newer AI and webhook settings.
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in Gemini
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of
YOUR_MCP_API_KEY. - Save the file and restart
gemini. - Run
/mcpinside Gemini CLI (orgemini mcp listin your shell) —anythingmcpshould show as connected. - Start prompting — Gemini CLI can now call the
sipgatetools.
Available tools
| Tool | What it does |
|---|---|
sipgate_get_user_info | Read who the access token belongs to: sub (the user id, e.g. w0, needed by the per-user tools), domain (sipgate.de or sipgate.co.uk)… |
sipgate_get_account | Read the sipgate account: company, the account holder's first and last name and e-mail, mainProductType (BASIC, TEAM, TRUNKING and so on)… |
sipgate_get_balance | Read the prepaid balance of the account: amount and currency. The amount is in ten-thousandths of the currency unit: 35000 means 3.50 EUR… |
sipgate_list_users | List the users of the account: id (w0, w1 and so on), firstname, lastname, email, admin, defaultDevice, busyOnBusy, directDialIds and… |
sipgate_get_user | Read one user of the account: firstname, lastname, email, admin, defaultDevice, busyOnBusy, addressId, directDialIds and timezone. Scope… |
sipgate_list_devices | List the devices of a user: id (e for a VoIP phone, y for a mobile SIM, x for an external number, followed by a number), alias, type… |
sipgate_get_device | Read one device: alias, type, online, dnd and the active phone lines and groups routed to it. Scope devices:read. Read-only |
sipgate_list_numbers | List the phone numbers of the account: number (international format), localized, type (LANDLINE, MOBILE, QUICKDIAL, INTERNATIONAL), and… |
sipgate_list_user_numbers | List the phone numbers routed to one user: number, localized, type, endpointId and endpointAlias. Scope numbers:read. Read-only |
sipgate_list_phonelines | List the phone lines (connections) of a user: id (p0, p1 and so on) and alias. A phone line carries the numbers, forwardings and voicemail… |
sipgate_list_forwardings | List the call forwarding rules of a phone line: destination (a number or a device), alias, timeout (seconds until the next step rings) and… |
sipgate_list_history | List the call history: calls, voicemails, SMS and faxes, newest first. Each entry has id, type, direction (INCOMING, OUTGOING… |
sipgate_get_history_entry | Read one entry of the history (a call, voicemail, SMS or fax) by its id: type, direction, status, source, target, created, the endpoints… |
sipgate_update_history_entry | Change the bookkeeping of one history entry: write a note on a call, mark it as read, star it or archive it. Only the fields you pass… |
sipgate_list_contacts | List the contacts of the address book: id, name, givenname, familyname, numbers (number and type), emails, addresses, organization, note… |
sipgate_get_contact | Read one contact of the address book by its id: name, numbers, emails, addresses, organization, note and scope. Scope contacts:read.… |
sipgate_create_contact | Add a contact to the address book, so that calls from its numbers show the name. Answers with status 201 and an empty body. A SHARED… |
sipgate_list_voicemails | List the voicemail boxes of the account: id (v0 and so on), alias and the phone line or group each belongs to. The recorded messages… |
sipgate_list_blocklist | List the numbers blocked for incoming calls: phoneNumber and isBlock (true when every number starting with it is blocked, which blocks a… |
sipgate_list_groups | List the call groups (hunt groups) of the account: id (g0 and so on) and alias. With user_id only the groups that user is in. A group rings… |
sipgate_list_group_users | List the members of a call group: id, firstname and lastname of each user. Scope groups:users:read. Read-only |
sipgate_list_active_calls | List the calls that are connected right now: callId, the participants with their phone numbers, and whether the call is muted, on hold or… |
sipgate_list_sms_extensions | List the SMS extensions of a user: id (s0 and so on), alias and callerId (the sender number). The id is the sms_id that sipgate_send_sms… |
sipgate_send_sms | Send an SMS from an SMS extension of the account. sipgate charges every SMS to the account balance, so the tool is installed switched off… |
sipgate_start_call | Start a phone call (click to call): sipgate first rings the caller's device and, once it is picked up, dials the callee. A real call is… |
Example prompts
- "Which calls did we miss today, and from which numbers?"
- "Show the new voicemails of this week with caller and time."
- "Who is on which phone number, and where are the forwardings set?"
- "What is the current balance of our sipgate account?"
- "Add a note to yesterday's call from +4930123456: called back, offer sent."
FAQ
Where does the token come from? In the sipgate web app open Personal access tokens, create a token, give it a name and tick the scopes you need. sipgate shows a Token ID (starting with token-) and the token itself, the token only once. A token sees what its user sees; entries of other users and the full user list need an administrator.
What does it cover? One sipgate account (team, trunking or basic, in Germany or the UK): account and balance, users, devices, phone numbers, phone lines and forwardings, the history of calls, voicemails, SMS and faxes with notes, stars and archiving, the address book, call groups, calls in progress and the blocklist. Changing forwardings, devices or numbers and sending faxes are not covered.
Which tools install switched off? sipgate_send_sms and sipgate_start_call, because both cost money. They also need the scopes sessions:sms:write and sessions:calls:write. Switch them on on the connector page only if the AI should use them.
Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.
Next steps
Was this guide helpful?