# Directory Structure
```
├── .gitignore
├── .python-version
├── main.py
├── pyproject.toml
├── README.md
└── uv.lock
```
# Files
--------------------------------------------------------------------------------
/.python-version:
--------------------------------------------------------------------------------
```
1 | 3.11
2 |
```
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
```
1 | # Byte-compiled / optimized / DLL files
2 | __pycache__/
3 | *.py[cod]
4 | *$py.class
5 |
6 | # C extensions
7 | *.so
8 |
9 | # Distribution / packaging
10 | .Python
11 | build/
12 | develop-eggs/
13 | dist/
14 | downloads/
15 | eggs/
16 | .eggs/
17 | lib/
18 | lib64/
19 | parts/
20 | sdist/
21 | var/
22 | wheels/
23 | share/python-wheels/
24 | *.egg-info/
25 | .installed.cfg
26 | *.egg
27 | MANIFEST
28 |
29 | # PyInstaller
30 | # Usually these files are written by a python script from a template
31 | # before PyInstaller builds the exe, so as to inject date/other infos into it.
32 | *.manifest
33 | *.spec
34 |
35 | # Installer logs
36 | pip-log.txt
37 | pip-delete-this-directory.txt
38 |
39 | # Unit test / coverage reports
40 | htmlcov/
41 | .tox/
42 | .nox/
43 | .coverage
44 | .coverage.*
45 | .cache
46 | nosetests.xml
47 | coverage.xml
48 | *.cover
49 | *.py,cover
50 | .hypothesis/
51 | .pytest_cache/
52 | cover/
53 |
54 | # Translations
55 | *.mo
56 | *.pot
57 |
58 | # Django stuff:
59 | *.log
60 | local_settings.py
61 | db.sqlite3
62 | db.sqlite3-journal
63 |
64 | # Flask stuff:
65 | instance/
66 | .webassets-cache
67 |
68 | # Scrapy stuff:
69 | .scrapy
70 |
71 | # Sphinx documentation
72 | docs/_build/
73 |
74 | # PyBuilder
75 | .pybuilder/
76 | target/
77 |
78 | # Jupyter Notebook
79 | .ipynb_checkpoints
80 |
81 | # IPython
82 | profile_default/
83 | ipython_config.py
84 |
85 | # pyenv
86 | # For a library or package, you might want to ignore these files since the code is
87 | # intended to run in multiple environments; otherwise, check them in:
88 | # .python-version
89 |
90 | # pipenv
91 | # According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
92 | # However, in case of collaboration, if having platform-specific dependencies or dependencies
93 | # having no cross-platform support, pipenv may install dependencies that don't work, or not
94 | # install all needed dependencies.
95 | #Pipfile.lock
96 |
97 | # UV
98 | # Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
99 | # This is especially recommended for binary packages to ensure reproducibility, and is more
100 | # commonly ignored for libraries.
101 | #uv.lock
102 |
103 | # poetry
104 | # Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
105 | # This is especially recommended for binary packages to ensure reproducibility, and is more
106 | # commonly ignored for libraries.
107 | # https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
108 | #poetry.lock
109 |
110 | # pdm
111 | # Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
112 | #pdm.lock
113 | # pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
114 | # in version control.
115 | # https://pdm.fming.dev/latest/usage/project/#working-with-version-control
116 | .pdm.toml
117 | .pdm-python
118 | .pdm-build/
119 |
120 | # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
121 | __pypackages__/
122 |
123 | # Celery stuff
124 | celerybeat-schedule
125 | celerybeat.pid
126 |
127 | # SageMath parsed files
128 | *.sage.py
129 |
130 | # Environments
131 | .env
132 | .venv
133 | env/
134 | venv/
135 | ENV/
136 | env.bak/
137 | venv.bak/
138 |
139 | # Spyder project settings
140 | .spyderproject
141 | .spyproject
142 |
143 | # Rope project settings
144 | .ropeproject
145 |
146 | # mkdocs documentation
147 | /site
148 |
149 | # mypy
150 | .mypy_cache/
151 | .dmypy.json
152 | dmypy.json
153 |
154 | # Pyre type checker
155 | .pyre/
156 |
157 | # pytype static type analyzer
158 | .pytype/
159 |
160 | # Cython debug symbols
161 | cython_debug/
162 |
163 | # PyCharm
164 | # JetBrains specific template is maintained in a separate JetBrains.gitignore that can
165 | # be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
166 | # and can be added to the global gitignore or merged into this file. For a more nuclear
167 | # option (not recommended) you can uncomment the following to ignore the entire idea folder.
168 | #.idea/
169 |
170 | # Ruff stuff:
171 | .ruff_cache/
172 |
173 | # PyPI configuration file
174 | .pypirc
175 |
```
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
```markdown
1 | # twilio-mcp-python
2 |
3 | This is a Twilio MCP server!
4 |
5 | Usage:
6 |
7 | Two tools currently:
8 |
9 | send_message and get_message_logs
10 |
11 | Future Work:
12 |
13 | Need to add prompts and call features
14 |
```
--------------------------------------------------------------------------------
/pyproject.toml:
--------------------------------------------------------------------------------
```toml
1 | [project]
2 | name = "twilio"
3 | version = "0.1.0"
4 | description = "Add your description here"
5 | readme = "README.md"
6 | requires-python = ">=3.11"
7 | dependencies = [
8 | "mcp[cli]>=1.4.1",
9 | ]
10 |
```
--------------------------------------------------------------------------------
/main.py:
--------------------------------------------------------------------------------
```python
1 | from dotenv import load_dotenv
2 | from mcp.server.fastmcp import FastMCP
3 | from twilio.rest import Client
4 |
5 | from typing import Annotated
6 |
7 | from pydantic import BeforeValidator
8 | from pydantic_settings import BaseSettings, SettingsConfigDict
9 |
10 | #import pydantic
11 | #from icecream import ic
12 |
13 |
14 | load_dotenv()
15 |
16 | class Credentials(BaseSettings):
17 |
18 | account_sid: str | None = None
19 | auth_token: str | None = None
20 | phone_number: Annotated[
21 | str,
22 | BeforeValidator(lambda v: v if v.startswith("+") else f"+{v}")
23 | ]
24 |
25 |
26 | model_config: SettingsConfigDict = SettingsConfigDict(
27 | env_prefix = "TWILIO_",
28 | env_file = ".env",
29 | env_file_encoding = "utf-8"
30 | )
31 |
32 |
33 | try:
34 | credentials = Credentials()
35 | client = Client(credentials.account_sid, credentials.auth_token)
36 |
37 | mcp = FastMCP(
38 | name="twilioServer",
39 | dependencies=["twilio", "python-dotenv", "pydantic", "typing"],
40 | description="A server that sends a message using Twilio",
41 | version="0.0.1"
42 | )
43 |
44 | except Exception as e:
45 | print(f"Error: {e}")
46 | exit(1)
47 |
48 |
49 | @mcp.tool(name='textme', description='Send a text message using Twilio')
50 | def send_message(to: str=credentials.phone_number, message: str="Hello world"):
51 | """
52 | Sends a message to a phone number using Twilio
53 | """
54 | try:
55 | message = client.messages.create(
56 | messaging_service_sid='MG67808210bf00bd0d6bbfece0cf6075e6',
57 | body=message,
58 | to=to
59 | )
60 |
61 | return [
62 | f"Message sent to {to}",
63 | message.sid,
64 | ]
65 | except Exception as e:
66 | return[
67 | f'Error sending message: {e}'
68 | ]
69 |
70 | @mcp.tool(name="msglogs", description="get the message logs for a number")
71 | def get_message_logs(phone_number: str=credentials.phone_number, limit: int=10):
72 | """
73 | Retrieves message logs for a specific phone number.
74 | """
75 | messages = client.messages.list(to=phone_number, limit=limit) # Last 10 messages
76 |
77 | if not messages:
78 | print(f"No messages found for {phone_number}")
79 | return
80 |
81 | for msg in messages:
82 | print(f"SID: {msg.sid} | Status: {msg.status} | Sent At: {msg.date_sent} | Body: {msg.body}")
83 |
84 |
85 |
86 |
87 |
88 |
89 |
90 |
91 |
```